mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-02 11:49:55 -06:00
Help: Improve clarity of foreach behavior
This commit is contained in:
@@ -58,7 +58,8 @@ command iterates over each item in each given list.
|
||||
The ``<items>`` following the ``ITEMS`` keyword are processed
|
||||
as in the first variant of the ``foreach`` command.
|
||||
The forms ``LISTS A`` and ``ITEMS ${A}`` are
|
||||
equivalent.
|
||||
equivalent. If no ``<lists>`` or ``<items>`` are given, the body
|
||||
of the loop will never be executed (i.e., it is processed as empty).
|
||||
|
||||
The following example shows how the ``LISTS`` option is
|
||||
processed:
|
||||
@@ -97,13 +98,18 @@ separated list of list-valued variables. The ``foreach``
|
||||
command iterates over each list simultaneously setting the
|
||||
iteration variables as follows:
|
||||
|
||||
- if the only ``loop_var`` given, then it sets a series of
|
||||
- if a single ``loop_var`` is given, then it sets a series of
|
||||
``loop_var_N`` variables to the current item from the
|
||||
corresponding list;
|
||||
- if multiple variable names passed, their count should match
|
||||
the lists variables count;
|
||||
- if any of the lists are shorter, the corresponding iteration
|
||||
variable is not defined for the current iteration.
|
||||
- if multiple variable names are passed, it sets each variable to the
|
||||
current item from the corresponding list. The number of iteration
|
||||
variables must match the number of list variables.
|
||||
|
||||
If no ``<lists>`` are given, the body of the loop will never be executed
|
||||
(i.e., it is processed as empty).
|
||||
|
||||
The following example shows how the ``ZIP_LISTS`` option is
|
||||
processed:
|
||||
|
||||
.. noqa: spellcheck off
|
||||
|
||||
|
||||
Reference in New Issue
Block a user