| 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:: STANDARD_ADVICE.txt |
| |
| .. include:: DEPRECATED.txt |
