Gecko [ www.finalhopeacademy.com ]

Name	Size	Permission
FIND_XXX.txt	5.77 KB	-rw-r--r--
FIND_XXX_ORDER.txt	446 B	-rw-r--r--
FIND_XXX_ROOT.txt	1.41 KB	-rw-r--r--
LINK_OPTIONS_LINKER.txt	1021 B	-rw-r--r--
OPTIONS_SHELL.txt	670 B	-rw-r--r--
add_compile_definitions.rst	1.03 KB	-rw-r--r--
add_compile_definitions.rst.re...	1.03 KB	-rw-r--r--
add_compile_options.rst	1.33 KB	-rw-r--r--
add_compile_options.rst.rename	1.33 KB	-rw-r--r--
add_custom_command.rst	12.2 KB	-rw-r--r--
add_custom_command.rst.rename	12.19 KB	-rw-r--r--
add_custom_target.rst	6.33 KB	-rw-r--r--
add_custom_target.rst.rename	6.33 KB	-rw-r--r--
add_definitions.rst	1.36 KB	-rw-r--r--
add_definitions.rst.rename	1.36 KB	-rw-r--r--
add_dependencies.rst	930 B	-rw-r--r--
add_executable.rst	3.91 KB	-rw-r--r--
add_executable.rst.rename	3.91 KB	-rw-r--r--
add_library.rst	7.9 KB	-rw-r--r--
add_library.rst.rename	7.9 KB	-rw-r--r--
add_link_options.rst	1.09 KB	-rw-r--r--
add_link_options.rst.rename	1.09 KB	-rw-r--r--
add_subdirectory.rst	1.75 KB	-rw-r--r--
add_test.rst	2.67 KB	-rw-r--r--
add_test.rst.rename	2.67 KB	-rw-r--r--
aux_source_directory.rst	1.06 KB	-rw-r--r--
break.rst	208 B	-rw-r--r--
build_command.rst	1.59 KB	-rw-r--r--
build_command.rst.rename	1.59 KB	-rw-r--r--
build_name.rst	411 B	-rw-r--r--
cmake_host_system_information....	2.57 KB	-rw-r--r--
cmake_minimum_required.rst	2.61 KB	-rw-r--r--
cmake_parse_arguments.rst	4.54 KB	-rw-r--r--
cmake_policy.rst	4.46 KB	-rw-r--r--
cmake_policy.rst.rename	4.46 KB	-rw-r--r--
configure_file.rst	3.73 KB	-rw-r--r--
continue.rst	323 B	-rw-r--r--
create_test_sourcelist.rst	1.52 KB	-rw-r--r--
ctest_build.rst	2.85 KB	-rw-r--r--
ctest_build.rst.rename	2.85 KB	-rw-r--r--
ctest_configure.rst	1.6 KB	-rw-r--r--
ctest_coverage.rst	1.55 KB	-rw-r--r--
ctest_empty_binary_directory.r...	304 B	-rw-r--r--
ctest_memcheck.rst	1.24 KB	-rw-r--r--
ctest_read_custom_files.rst	315 B	-rw-r--r--
ctest_read_custom_files.rst.re...	314 B	-rw-r--r--
ctest_run_script.rst	539 B	-rw-r--r--
ctest_sleep.rst	227 B	-rw-r--r--
ctest_start.rst	3.04 KB	-rw-r--r--
ctest_submit.rst	3.53 KB	-rw-r--r--
ctest_test.rst	5.12 KB	-rw-r--r--
ctest_test.rst.rename	5.12 KB	-rw-r--r--
ctest_update.rst	1.27 KB	-rw-r--r--
ctest_upload.rst	609 B	-rw-r--r--
define_property.rst	2.54 KB	-rw-r--r--
else.rst	129 B	-rw-r--r--
elseif.rst	194 B	-rw-r--r--
enable_language.rst	1.06 KB	-rw-r--r--
enable_testing.rst	474 B	-rw-r--r--
endforeach.rst	342 B	-rw-r--r--
endfunction.rst	337 B	-rw-r--r--
endif.rst	300 B	-rw-r--r--
endmacro.rst	319 B	-rw-r--r--
endwhile.rst	317 B	-rw-r--r--
exec_program.rst	939 B	-rw-r--r--
execute_process.rst	4.66 KB	-rw-r--r--
export.rst	3.92 KB	-rw-r--r--
export_library_dependencies.rs...	1.11 KB	-rw-r--r--
file.rst	32.15 KB	-rw-r--r--
file.rst.rename	32.15 KB	-rw-r--r--
find_file.rst	1.49 KB	-rw-r--r--
find_library.rst	3.8 KB	-rw-r--r--
find_package.rst	18.59 KB	-rw-r--r--
find_package.rst.rename	18.59 KB	-rw-r--r--
find_path.rst	1.78 KB	-rw-r--r--
find_program.rst	1.38 KB	-rw-r--r--
fltk_wrap_ui.rst	380 B	-rw-r--r--
foreach.rst	3.34 KB	-rw-r--r--
function.rst	2.08 KB	-rw-r--r--
get_cmake_property.rst	756 B	-rw-r--r--
get_cmake_property.rst.rename	755 B	-rw-r--r--
get_directory_property.rst	1.02 KB	-rw-r--r--
get_filename_component.rst	1.9 KB	-rw-r--r--
get_property.rst	1.99 KB	-rw-r--r--
get_source_file_property.rst	929 B	-rw-r--r--
get_target_property.rst	1.07 KB	-rw-r--r--
get_test_property.rst	785 B	-rw-r--r--
if.rst	11.02 KB	-rw-r--r--
include.rst	1.06 KB	-rw-r--r--
include_directories.rst	1.7 KB	-rw-r--r--
include_directories.rst.rename	1.7 KB	-rw-r--r--
include_external_msproject.rst	1.06 KB	-rw-r--r--
include_guard.rst	1.78 KB	-rw-r--r--
include_regular_expression.rst	571 B	-rw-r--r--
install.rst	32.05 KB	-rw-r--r--
install.rst.rename	32.04 KB	-rw-r--r--
install_files.rst	1.34 KB	-rw-r--r--
install_programs.rst	1.22 KB	-rw-r--r--
install_targets.rst	645 B	-rw-r--r--
link_directories.rst	2.35 KB	-rw-r--r--
link_directories.rst.rename	2.35 KB	-rw-r--r--
link_libraries.rst	669 B	-rw-r--r--
list.rst	8.75 KB	-rw-r--r--
list.rst.rename	8.75 KB	-rw-r--r--
load_cache.rst	1001 B	-rw-r--r--
load_command.rst	648 B	-rw-r--r--
macro.rst	4.55 KB	-rw-r--r--
make_directory.rst	287 B	-rw-r--r--
mark_as_advanced.rst	956 B	-rw-r--r--
math.rst	1.13 KB	-rw-r--r--
message.rst	6.26 KB	-rw-r--r--
option.rst	495 B	-rw-r--r--
output_required_files.rst	661 B	-rw-r--r--
project.rst	4.78 KB	-rw-r--r--
qt_wrap_cpp.rst	829 B	-rw-r--r--
qt_wrap_ui.rst	981 B	-rw-r--r--
remove.rst	287 B	-rw-r--r--
remove_definitions.rst	293 B	-rw-r--r--
return.rst	731 B	-rw-r--r--
separate_arguments.rst	1.58 KB	-rw-r--r--
set.rst	3.86 KB	-rw-r--r--
set.rst.rename	3.85 KB	-rw-r--r--
set_directory_properties.rst	494 B	-rw-r--r--
set_property.rst	2.87 KB	-rw-r--r--
set_property.rst.rename	2.87 KB	-rw-r--r--
set_source_files_properties.rs...	616 B	-rw-r--r--
set_target_properties.rst	684 B	-rw-r--r--
set_tests_properties.rst	530 B	-rw-r--r--
set_tests_properties.rst.renam...	529 B	-rw-r--r--
site_name.rst	119 B	-rw-r--r--
source_group.rst	1.75 KB	-rw-r--r--
string.rst	13.39 KB	-rw-r--r--
string.rst.rename	13.39 KB	-rw-r--r--
subdir_depends.rst	287 B	-rw-r--r--
subdirs.rst	1.03 KB	-rw-r--r--
target_compile_definitions.rst	1.69 KB	-rw-r--r--
target_compile_definitions.rst...	1.69 KB	-rw-r--r--
target_compile_features.rst	1.52 KB	-rw-r--r--
target_compile_features.rst.re...	1.52 KB	-rw-r--r--
target_compile_options.rst	1.85 KB	-rw-r--r--
target_compile_options.rst.ren...	1.85 KB	-rw-r--r--
target_include_directories.rst	2.76 KB	-rw-r--r--
target_include_directories.rst...	2.76 KB	-rw-r--r--
target_link_directories.rst	2.57 KB	-rw-r--r--
target_link_directories.rst.re...	2.57 KB	-rw-r--r--
target_link_libraries.rst	12.71 KB	-rw-r--r--
target_link_libraries.rst.rena...	12.71 KB	-rw-r--r--
target_link_options.rst	1.92 KB	-rw-r--r--
target_link_options.rst.rename	1.92 KB	-rw-r--r--
target_precompile_headers.rst	5.28 KB	-rw-r--r--
target_sources.rst	1.44 KB	-rw-r--r--
target_sources.rst.rename	1.44 KB	-rw-r--r--
try_compile.rst	7.65 KB	-rw-r--r--
try_compile.rst.rename	7.65 KB	-rw-r--r--
try_run.rst	3.98 KB	-rw-r--r--
try_run.rst.rename	3.98 KB	-rw-r--r--
unset.rst	1.5 KB	-rw-r--r--
unset.rst.rename	1.5 KB	-rw-r--r--
use_mangled_mesa.rst	456 B	-rw-r--r--
utility_source.rst	958 B	-rw-r--r--
variable_requires.rst	765 B	-rw-r--r--
variable_watch.rst	421 B	-rw-r--r--
while.rst	787 B	-rw-r--r--
write_file.rst	686 B	-rw-r--r--

Code Editor : try_compile.rst

try_compile
-----------

.. only:: html

.. contents::

Try building some code.

Try Compiling Whole Projects
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: cmake

try_compile(<resultVar> <bindir> <srcdir>
              <projectName> [<targetName>] [CMAKE_FLAGS <flags>...]
              [OUTPUT_VARIABLE <var>])

Try building a project.  The success or failure of the ``try_compile``,
i.e. ``TRUE`` or ``FALSE`` respectively, is returned in ``<resultVar>``.

In this form, ``<srcdir>`` should contain a complete CMake project with a
``CMakeLists.txt`` file and all sources.  The ``<bindir>`` and ``<srcdir>``
will not be deleted after this command is run.  Specify ``<targetName>`` to
build a specific target instead of the ``all`` or ``ALL_BUILD`` target.  See
below for the meaning of other options.

Try Compiling Source Files
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. code-block:: cmake

try_compile(<resultVar> <bindir> <srcfile|SOURCES srcfile...>
              [CMAKE_FLAGS <flags>...]
              [COMPILE_DEFINITIONS <defs>...]
              [LINK_OPTIONS <options>...]
              [LINK_LIBRARIES <libs>...]
              [OUTPUT_VARIABLE <var>]
              [COPY_FILE <fileName> [COPY_FILE_ERROR <var>]]
              [<LANG>_STANDARD <std>]
              [<LANG>_STANDARD_REQUIRED <bool>]
              [<LANG>_EXTENSIONS <bool>]
              )

Try building an executable or static library from one or more source files
(which one is determined by the :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE`
variable).  The success or failure of the ``try_compile``, i.e. ``TRUE`` or
``FALSE`` respectively, is returned in ``<resultVar>``.

In this form, one or more source files must be provided.  If
:variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` is unset or is set to ``EXECUTABLE``,
the sources must include a definition for ``main`` and CMake will create a
``CMakeLists.txt`` file to build the source(s) as an executable.
If :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` is set to ``STATIC_LIBRARY``,
a static library will be built instead and no definition for ``main`` is
required.  For an executable, the generated ``CMakeLists.txt`` file would
contain something like the following:

.. code-block:: cmake

add_definitions(<expanded COMPILE_DEFINITIONS from caller>)
  include_directories(${INCLUDE_DIRECTORIES})
  link_directories(${LINK_DIRECTORIES})
  add_executable(cmTryCompileExec <srcfile>...)
  target_link_options(cmTryCompileExec PRIVATE <LINK_OPTIONS from caller>)
  target_link_libraries(cmTryCompileExec ${LINK_LIBRARIES})

The options are:

``CMAKE_FLAGS <flags>...``
  Specify flags of the form ``-DVAR:TYPE=VALUE`` to be passed to
  the ``cmake3`` command-line used to drive the test build.
  The above example shows how values for variables
  ``INCLUDE_DIRECTORIES``, ``LINK_DIRECTORIES``, and ``LINK_LIBRARIES``
  are used.

``COMPILE_DEFINITIONS <defs>...``
  Specify ``-Ddefinition`` arguments to pass to :command:`add_definitions`
  in the generated test project.

``COPY_FILE <fileName>``
  Copy the built executable or static library to the given ``<fileName>``.

``COPY_FILE_ERROR <var>``
  Use after ``COPY_FILE`` to capture into variable ``<var>`` any error
  message encountered while trying to copy the file.

``LINK_LIBRARIES <libs>...``
  Specify libraries to be linked in the generated project.
  The list of libraries may refer to system libraries and to
  :ref:`Imported Targets <Imported Targets>` from the calling project.

If this option is specified, any ``-DLINK_LIBRARIES=...`` value
  given to the ``CMAKE_FLAGS`` option will be ignored.

``LINK_OPTIONS <options>...``
  Specify link step options to pass to :command:`target_link_options` or to
  set the :prop_tgt:`STATIC_LIBRARY_OPTIONS` target property in the generated
  project, depending on the :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable.

``OUTPUT_VARIABLE <var>``
  Store the output from the build process in the given variable.

``<LANG>_STANDARD <std>``
  Specify the :prop_tgt:`C_STANDARD`, :prop_tgt:`CXX_STANDARD`,
  :prop_tgt:`OBJC_STANDARD`, :prop_tgt:`OBJCXX_STANDARD`,
  or :prop_tgt:`CUDA_STANDARD` target property of the generated project.

``<LANG>_STANDARD_REQUIRED <bool>``
  Specify the :prop_tgt:`C_STANDARD_REQUIRED`,
  :prop_tgt:`CXX_STANDARD_REQUIRED`, :prop_tgt:`OBJC_STANDARD_REQUIRED`,
  :prop_tgt:`OBJCXX_STANDARD_REQUIRED`,or :prop_tgt:`CUDA_STANDARD_REQUIRED`
  target property of the generated project.

``<LANG>_EXTENSIONS <bool>``
  Specify the :prop_tgt:`C_EXTENSIONS`, :prop_tgt:`CXX_EXTENSIONS`,
  :prop_tgt:`OBJC_EXTENSIONS`, :prop_tgt:`OBJCXX_EXTENSIONS`,
  or :prop_tgt:`CUDA_EXTENSIONS` target property of the generated project.

In this version all files in ``<bindir>/CMakeFiles/CMakeTmp`` will be
cleaned automatically.  For debugging, ``--debug-trycompile`` can be
passed to ``cmake3`` to avoid this clean.  However, multiple sequential
``try_compile`` operations reuse this single output directory.  If you use
``--debug-trycompile``, you can only debug one ``try_compile`` call at a time.
The recommended procedure is to protect all ``try_compile`` calls in your
project by ``if(NOT DEFINED <resultVar>)`` logic, configure with cmake
all the way through once, then delete the cache entry associated with
the try_compile call of interest, and then re-run cmake again with
``--debug-trycompile``.

Other Behavior Settings
^^^^^^^^^^^^^^^^^^^^^^^

If set, the following variables are passed in to the generated
try_compile CMakeLists.txt to initialize compile target properties with
default values:

* :variable:`CMAKE_CUDA_RUNTIME_LIBRARY`
* :variable:`CMAKE_ENABLE_EXPORTS`
* :variable:`CMAKE_LINK_SEARCH_START_STATIC`
* :variable:`CMAKE_LINK_SEARCH_END_STATIC`
* :variable:`CMAKE_MSVC_RUNTIME_LIBRARY`
* :variable:`CMAKE_POSITION_INDEPENDENT_CODE`

If :policy:`CMP0056` is set to ``NEW``, then
:variable:`CMAKE_EXE_LINKER_FLAGS` is passed in as well.

If :policy:`CMP0083` is set to ``NEW``, then in order to obtain correct
behavior at link time, the ``check_pie_supported()`` command from the
:module:`CheckPIESupported` module must be called before using the
:command:`try_compile` command.

The current settings of :policy:`CMP0065` and :policy:`CMP0083` are propagated
through to the generated test project.

Set the :variable:`CMAKE_TRY_COMPILE_CONFIGURATION` variable to choose
a build configuration.

Set the :variable:`CMAKE_TRY_COMPILE_TARGET_TYPE` variable to specify
the type of target used for the source file signature.

Set the :variable:`CMAKE_TRY_COMPILE_PLATFORM_VARIABLES` variable to specify
variables that must be propagated into the test project.  This variable is
meant for use only in toolchain files and is only honored by the
``try_compile()`` command for the source files form, not when given a whole
project.

If :policy:`CMP0067` is set to ``NEW``, or any of the ``<LANG>_STANDARD``,
``<LANG>_STANDARD_REQUIRED``, or ``<LANG>_EXTENSIONS`` options are used,
then the language standard variables are honored:

* :variable:`CMAKE_C_STANDARD`
* :variable:`CMAKE_C_STANDARD_REQUIRED`
* :variable:`CMAKE_C_EXTENSIONS`
* :variable:`CMAKE_CXX_STANDARD`
* :variable:`CMAKE_CXX_STANDARD_REQUIRED`
* :variable:`CMAKE_CXX_EXTENSIONS`
* :variable:`CMAKE_OBJC_STANDARD`
* :variable:`CMAKE_OBJC_STANDARD_REQUIRED`
* :variable:`CMAKE_OBJC_EXTENSIONS`
* :variable:`CMAKE_OBJCXX_STANDARD`
* :variable:`CMAKE_OBJCXX_STANDARD_REQUIRED`
* :variable:`CMAKE_OBJCXX_EXTENSIONS`
* :variable:`CMAKE_CUDA_STANDARD`
* :variable:`CMAKE_CUDA_STANDARD_REQUIRED`
* :variable:`CMAKE_CUDA_EXTENSIONS`

Their values are used to set the corresponding target properties in
the generated project (unless overridden by an explicit option).

For the :generator:`Green Hills MULTI` generator the GHS toolset and target
system customization cache variables are also propagated into the test project.

${this.title}

Code Editor : try_compile.rst