CMake/Modules/CheckCXXSourceRuns.cmake
Kitware Robot 1772622772 LICENSE: Replace references to Copyright.txt with LICENSE.rst
```
git grep -lz 'Copyright.txt or https://cmake.org/licensing ' |
  while IFS= read -r -d $'\0' f ; do
    sed -i '/Copyright.txt or https:\/\/cmake.org\/licensing / {
              s/Copyright.txt/LICENSE.rst/
            }' "$f" ; done
```
2025-03-03 10:43:35 -05:00

55 lines
1.8 KiB
CMake

# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
# file LICENSE.rst or https://cmake.org/licensing for details.
#[=======================================================================[.rst:
CheckCXXSourceRuns
------------------
Check once if given C++ source compiles and links into an executable and can
subsequently be run.
.. command:: check_cxx_source_runs
.. code-block:: cmake
check_cxx_source_runs(<code> <resultVar>)
Check once that the source supplied in ``<code>`` can be built, linked as an
executable, and then run. The ``<code>`` must contain at least a ``main()``
function.
The result is stored in the internal cache variable specified by
``<resultVar>``. If the code builds and runs with exit code ``0``, success is
indicated by boolean ``true``. Failure to build or run is indicated by boolean
``false``, such as an empty string or an error message.
See also :command:`check_source_runs` for a more general command syntax.
The compile and link commands can be influenced by setting any of the
following variables prior to calling ``check_cxx_source_runs()``:
.. include:: /module/CMAKE_REQUIRED_FLAGS.txt
.. include:: /module/CMAKE_REQUIRED_DEFINITIONS.txt
.. include:: /module/CMAKE_REQUIRED_INCLUDES.txt
.. include:: /module/CMAKE_REQUIRED_LINK_OPTIONS.txt
.. include:: /module/CMAKE_REQUIRED_LIBRARIES.txt
.. include:: /module/CMAKE_REQUIRED_LINK_DIRECTORIES.txt
.. include:: /module/CMAKE_REQUIRED_QUIET.txt
#]=======================================================================]
include_guard(GLOBAL)
include(Internal/CheckSourceRuns)
macro(CHECK_CXX_SOURCE_RUNS SOURCE VAR)
set(_CheckSourceRuns_old_signature 1)
cmake_check_source_runs(CXX "${SOURCE}" ${VAR} ${ARGN})
unset(_CheckSourceRuns_old_signature)
endmacro()