mirror of
https://github.com/Kitware/CMake.git
synced 2026-02-14 02:59:53 -06:00
24 lines
931 B
ReStructuredText
24 lines
931 B
ReStructuredText
CMP0159
|
|
-------
|
|
|
|
.. versionadded:: 3.29
|
|
|
|
:command:`file(STRINGS)` with ``REGEX`` updates :variable:`CMAKE_MATCH_<n>`.
|
|
|
|
In CMake 3.28 and below the :command:`file(STRINGS)` command's ``REGEX``
|
|
option does not affect :variable:`CMAKE_MATCH_<n>` variables. CMake 3.29
|
|
and above prefer to update the :variable:`CMAKE_MATCH_<n>` variables using
|
|
captures from the last match in the file, similar to the
|
|
:command:`string(REGEX MATCHALL)` command. This policy provides
|
|
compatibility for projects that have not been updated to expect the behavior.
|
|
|
|
The ``OLD`` behavior for this policy is for :command:`file(STRINGS)` with
|
|
``REGEX`` to not store capture groups in :variable:`CMAKE_MATCH_<n>`
|
|
variables. The ``NEW`` behavior is to store the capture groups.
|
|
|
|
.. |INTRODUCED_IN_CMAKE_VERSION| replace:: 3.29
|
|
.. |WARNS_OR_DOES_NOT_WARN| replace:: does *not* warn
|
|
.. include:: include/STANDARD_ADVICE.rst
|
|
|
|
.. include:: include/DEPRECATED.rst
|