mirror/CMake
1
0
Fork 0
mirror of https://github.com/Kitware/CMake.git synced 2026-01-07 06:09:52 -06:00
Code Issues Packages Projects Releases Wiki Activity

Help: Document CMAKE_MATCH_<n> variables

Browse Source
This commit is contained in:
Brad King
2017-04-18 14:45:49 -04:00
parent 8dd9975263
commit eb08e1febb
5 changed files with 17 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
Help/command/if.rst
View File

@@ -104,6 +104,7 @@ Possible expressions are:
``if(<variable|string> MATCHES regex)`` ``if(<variable|string> MATCHES regex)``
True if the given string or variable's value matches the given regular True if the given string or variable's value matches the given regular
expression. See :ref:`Regex Specification` for regex format. expression. See :ref:`Regex Specification` for regex format.
``()`` groups are captured in :variable:`CMAKE_MATCH_<n>` variables.
``if(<variable|string> LESS <variable|string>)`` ``if(<variable|string> LESS <variable|string>)``
True if the given string or variable's value is a valid number and less True if the given string or variable's value is a valid number and less

2
Help/command/string.rst
View File

@@ -113,7 +113,7 @@ The following characters have special meaning in regular expressions:
in the ``REGEX REPLACE`` operation. Additionally it is saved in the ``REGEX REPLACE`` operation. Additionally it is saved
by all regular expression-related commands, including by all regular expression-related commands, including
e.g. :command:`if(MATCHES)`, in the variables e.g. :command:`if(MATCHES)`, in the variables
``CMAKE_MATCH_<n>`` for ``<n>`` 0..9. :variable:`CMAKE_MATCH_<n>` for ``<n>`` 0..9.
``*``, ``+`` and ``?`` have higher precedence than concatenation. ``|`` ``*``, ``+`` and ``?`` have higher precedence than concatenation. ``|``
has lower precedence than concatenation. This means that the regular has lower precedence than concatenation. This means that the regular

1
Help/manual/cmake-variables.7.rst
View File

@@ -56,6 +56,7 @@ Variables that Provide Information
/variable/CMAKE_MAJOR_VERSION /variable/CMAKE_MAJOR_VERSION
/variable/CMAKE_MAKE_PROGRAM /variable/CMAKE_MAKE_PROGRAM
/variable/CMAKE_MATCH_COUNT /variable/CMAKE_MATCH_COUNT
/variable/CMAKE_MATCH_n
/variable/CMAKE_MINIMUM_REQUIRED_VERSION /variable/CMAKE_MINIMUM_REQUIRED_VERSION
/variable/CMAKE_MINOR_VERSION /variable/CMAKE_MINOR_VERSION
/variable/CMAKE_PARENT_LIST_FILE /variable/CMAKE_PARENT_LIST_FILE

7
Help/variable/CMAKE_MATCH_COUNT.rst
View File

@@ -3,6 +3,7 @@ CMAKE_MATCH_COUNT
The number of matches with the last regular expression. The number of matches with the last regular expression.
When a regular expression match is used, CMake fills in ``CMAKE_MATCH_<n>`` When a regular expression match is used, CMake fills in
variables with the match contents. The ``CMAKE_MATCH_COUNT`` variable holds :variable:`CMAKE_MATCH_<n>` variables with the match contents.
the number of match expressions when these are filled. The ``CMAKE_MATCH_COUNT`` variable holds the number of match
expressions when these are filled.

10
Help/variable/CMAKE_MATCH_n.rst Normal file
View File

@@ -0,0 +1,10 @@
CMAKE_MATCH_<n>
---------------
Capture group ``<n>`` matched by the last regular expression, for groups
0 through 9. Group 0 is the entire match. Groups 1 through 9 are the
subexpressions captured by ``()`` syntax.
When a regular expression match is used, CMake fills in ``CMAKE_MATCH_<n>``
variables with the match contents. The :variable:`CMAKE_MATCH_COUNT`
variable holds the number of match expressions when these are filled.