| while |
| ----- |
| |
| Evaluate a group of commands while a condition is true |
| |
| .. code-block:: cmake |
| |
| while(<condition>) |
| <commands> |
| endwhile() |
| |
| All commands between while and the matching :command:`endwhile` are recorded |
| without being invoked. Once the :command:`endwhile` is evaluated, the |
| recorded list of commands is invoked as long as the ``<condition>`` is true. |
| |
| The ``<condition>`` has the same syntax and is evaluated using the same logic |
| as described at length for the :command:`if` command. |
| |
| The commands :command:`break` and :command:`continue` provide means to |
| escape from the normal control flow. |
| |
| Per legacy, the :command:`endwhile` command admits |
| an optional ``<condition>`` argument. |
| If used, it must be a verbatim repeat of the argument of the opening |
| ``while`` command. |