OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 add_compile_definitions.html	8.97 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_compile_options.html	13.11 KB	04/04/2023 07:04:57 PM	rw-r--r--
📄 add_custom_command.html	67.2 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_custom_target.html	26.7 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_definitions.html	9.72 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_dependencies.html	8.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_executable.html	20.23 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_library.html	43.25 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_link_options.html	17.79 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_subdirectory.html	8.85 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 add_test.html	17.09 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 aux_source_directory.html	6.45 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 block.html	13.15 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 break.html	5.97 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_command.html	10.66 KB	04/04/2023 07:04:58 PM	rw-r--r--
📄 build_name.html	6.43 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_host_system_information.html	38.46 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_language.html	59.74 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_minimum_required.html	13.56 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_parse_arguments.html	18.62 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_path.html	80.45 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 cmake_policy.html	23.14 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 configure_file.html	20.36 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 continue.html	6.15 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 create_test_sourcelist.html	7.61 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_build.html	14.87 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_configure.html	10.28 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_coverage.html	9.93 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_empty_binary_directory.html	5.54 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_memcheck.html	11.73 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_read_custom_files.html	5.78 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_run_script.html	6.72 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_sleep.html	5.66 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_start.html	14.68 KB	04/04/2023 07:04:59 PM	rw-r--r--
📄 ctest_submit.html	16.18 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_test.html	38.64 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_update.html	8.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 ctest_upload.html	6.7 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 define_property.html	15.53 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 else.html	5.35 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 elseif.html	5.44 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_language.html	10.08 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 enable_testing.html	6.04 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endblock.html	5.66 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endforeach.html	5.88 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endfunction.html	5.85 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endif.html	5.71 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endmacro.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 endwhile.html	5.79 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 exec_program.html	7.52 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 execute_process.html	20.95 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export.html	19.49 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 export_library_dependencies.html	8.01 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 file.html	128.25 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_file.html	39.65 KB	04/04/2023 07:05:00 PM	rw-r--r--
📄 find_library.html	46.52 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_package.html	91.29 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_path.html	40.22 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 find_program.html	37.17 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 fltk_wrap_ui.html	5.8 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 foreach.html	18.65 KB	04/04/2023 07:05:01 PM	rw-r--r--
📄 function.html	12.42 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_cmake_property.html	8.05 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_directory_property.html	9.08 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_filename_component.html	12.57 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_property.html	15.95 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_source_file_property.html	11.47 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_target_property.html	9.1 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 get_test_property.html	8.06 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 if.html	41.89 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include.html	8.04 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_directories.html	10.54 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_external_msproject.html	8.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_guard.html	8.85 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 include_regular_expression.html	6.14 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install.html	126.44 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_files.html	9.13 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_programs.html	9.09 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 install_targets.html	7 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_directories.html	11.99 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 link_libraries.html	7.36 KB	04/04/2023 07:05:02 PM	rw-r--r--
📄 list.html	35.79 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_cache.html	6.78 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 load_command.html	6.61 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 macro.html	20.49 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 make_directory.html	5.77 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 mark_as_advanced.html	6.73 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 math.html	9.01 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 message.html	27.67 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 option.html	6.48 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 output_required_files.html	6.59 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 project.html	30.84 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_cpp.html	7.2 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 qt_wrap_ui.html	7.43 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove.html	6 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 remove_definitions.html	6.15 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 return.html	16.06 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 separate_arguments.html	11.04 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set.html	18.35 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_directory_properties.html	7.58 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_property.html	17.74 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_source_files_properties.html	10.63 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_target_properties.html	8.33 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 set_tests_properties.html	7.98 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 site_name.html	5.46 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 source_group.html	10.97 KB	04/04/2023 07:05:03 PM	rw-r--r--
📄 string.html	64.24 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdir_depends.html	5.69 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 subdirs.html	7.51 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_definitions.html	16.09 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_features.html	14.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_compile_options.html	18.02 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_include_directories.html	22.39 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_directories.html	16.03 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_libraries.html	60.83 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_link_options.html	23.66 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_precompile_headers.html	24.42 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 target_sources.html	38.35 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_compile.html	57.47 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 try_run.html	24.62 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 unset.html	9.21 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 use_mangled_mesa.html	5.91 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 utility_source.html	6.78 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_requires.html	6.84 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 variable_watch.html	8.98 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 while.html	9.14 KB	04/04/2023 07:05:04 PM	rw-r--r--
📄 write_file.html	7.25 KB	04/04/2023 07:05:04 PM	rw-r--r--

Editing: cmake_language.html

<!DOCTYPE html>

<title>cmake_language &mdash; CMake 3.26.3 Documentation</title>

</head><body>

<div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 accesskey="I">index</a></li>
 <li class="right" >
 <a href="cmake_minimum_required.html" title="cmake_minimum_required"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="cmake_host_system_information.html" title="cmake_host_system_information"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" accesskey="U">cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">cmake_language</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-language">
<h1>cmake_language<a class="headerlink" href="#cmake-language" title="Permalink to this heading">¶</a></h1>
<div class="versionadded">
New in version 3.18.
</div>
Call meta-operations on CMake commands.
<section id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this heading">¶</a></h2>
<pre class="literal-block">cmake_language(<a class="reference internal" href="#call">CALL</a> &lt;command&gt; [&lt;arg&gt;...])
cmake_language(<a class="reference internal" href="#eval">EVAL</a> CODE &lt;code&gt;...)
cmake_language(<a class="reference internal" href="#defer">DEFER</a> &lt;options&gt;... CALL &lt;command&gt; [&lt;arg&gt;...])
cmake_language(<a class="reference internal" href="#set-dependency-provider">SET_DEPENDENCY_PROVIDER</a> &lt;command&gt; SUPPORTED_METHODS &lt;methods&gt;...)
cmake_language(<a class="reference internal" href="#get-message-log-level">GET_MESSAGE_LOG_LEVEL</a> &lt;out-var&gt;)</pre>
</section>
<section id="introduction">
<h2>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2>
This command will call meta-operations on built-in CMake commands or
those created via the <a class="reference internal" href="macro.html#command:macro" title="macro"><code class="xref cmake cmake-command docutils literal notranslate">macro()</code></a> or <a class="reference internal" href="function.html#command:function" title="function"><code class="xref cmake cmake-command docutils literal notranslate">function()</code></a> commands.
<code class="docutils literal notranslate">cmake_language</code> does not introduce a new variable or policy scope.
</section>
<section id="calling-commands">
<h2>Calling Commands<a class="headerlink" href="#calling-commands" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="call"><div class="highlight"><pre>cmake_language(CALL &lt;command&gt; [&lt;arg&gt;...])
</pre></div>
</div>
Calls the named <code class="docutils literal notranslate">&lt;command&gt;</code> with the given arguments (if any).
For example, the code:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(message_command &quot;message&quot;)
cmake_language(CALL ${message_command} STATUS &quot;Hello World!&quot;)
</pre></div>
</div>
is equivalent to
<div class="highlight-cmake notranslate"><div class="highlight"><pre>message(STATUS &quot;Hello World!&quot;)
</pre></div>
</div>
<div class="admonition note">
Note
To ensure consistency of the code, the following commands are not allowed:
<ul class="simple">
<li><code class="docutils literal notranslate">if</code> / <code class="docutils literal notranslate">elseif</code> / <code class="docutils literal notranslate">else</code> / <code class="docutils literal notranslate">endif</code></li>
<li><code class="docutils literal notranslate">block</code> / <code class="docutils literal notranslate">endblock</code></li>
<li><code class="docutils literal notranslate">while</code> / <code class="docutils literal notranslate">endwhile</code></li>
<li><code class="docutils literal notranslate">foreach</code> / <code class="docutils literal notranslate">endforeach</code></li>
<li><code class="docutils literal notranslate">function</code> / <code class="docutils literal notranslate">endfunction</code></li>
<li><code class="docutils literal notranslate">macro</code> / <code class="docutils literal notranslate">endmacro</code></li>
</ul>
</div>
</section>
<section id="evaluating-code">
<h2>Evaluating Code<a class="headerlink" href="#evaluating-code" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="eval"><div class="highlight"><pre>cmake_language(EVAL CODE &lt;code&gt;...)
</pre></div>
</div>
Evaluates the <code class="docutils literal notranslate">&lt;code&gt;...</code> as CMake code.
For example, the code:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(A TRUE)
set(B TRUE)
set(C TRUE)
set(condition &quot;(A AND B) OR C&quot;)

cmake_language(EVAL CODE &quot;
 if (${condition})
 message(STATUS TRUE)
 else()
 message(STATUS FALSE)
 endif()&quot;
)
</pre></div>
</div>
is equivalent to
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(A TRUE)
set(B TRUE)
set(C TRUE)
set(condition &quot;(A AND B) OR C&quot;)

file(WRITE ${CMAKE_CURRENT_BINARY_DIR}/eval.cmake &quot;
 if (${condition})
 message(STATUS TRUE)
 else()
 message(STATUS FALSE)
 endif()&quot;
)

include(${CMAKE_CURRENT_BINARY_DIR}/eval.cmake)
</pre></div>
</div>
</section>
<section id="deferring-calls">
<h2>Deferring Calls<a class="headerlink" href="#deferring-calls" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.19.
</div>
<div class="highlight-cmake notranslate" id="defer"><div class="highlight"><pre>cmake_language(DEFER &lt;options&gt;... CALL &lt;command&gt; [&lt;arg&gt;...])
</pre></div>
</div>
Schedules a call to the named <code class="docutils literal notranslate">&lt;command&gt;</code> with the given arguments (if any)
to occur at a later time. By default, deferred calls are executed as if
written at the end of the current directory's <code class="docutils literal notranslate">CMakeLists.txt</code> file,
except that they run even after a <a class="reference internal" href="return.html#command:return" title="return"><code class="xref cmake cmake-command docutils literal notranslate">return()</code></a> call. Variable
references in arguments are evaluated at the time the deferred call is
executed.
The options are:
<dl>
<dt><code class="docutils literal notranslate">DIRECTORY &lt;dir&gt;</code></dt><dd>Schedule the call for the end of the given directory instead of the
current directory. The <code class="docutils literal notranslate">&lt;dir&gt;</code> may reference either a source
directory or its corresponding binary directory. Relative paths are
treated as relative to the current source directory.
The given directory must be known to CMake, being either the top-level
directory or one added by <a class="reference internal" href="add_subdirectory.html#command:add_subdirectory" title="add_subdirectory"><code class="xref cmake cmake-command docutils literal notranslate">add_subdirectory()</code></a>. Furthermore,
the given directory must not yet be finished processing. This means
it can be the current directory or one of its ancestors.
</dd>
<dt><code class="docutils literal notranslate">ID &lt;id&gt;</code></dt><dd>Specify an identification for the deferred call.
The <code class="docutils literal notranslate">&lt;id&gt;</code> may not be empty and may not begin with a capital letter <code class="docutils literal notranslate">A-Z</code>.
The <code class="docutils literal notranslate">&lt;id&gt;</code> may begin with an underscore (<code class="docutils literal notranslate">_</code>) only if it was generated
automatically by an earlier call that used <code class="docutils literal notranslate">ID_VAR</code> to get the id.
</dd>
<dt><code class="docutils literal notranslate">ID_VAR &lt;var&gt;</code></dt><dd>Specify a variable in which to store the identification for the
deferred call. If <code class="docutils literal notranslate">ID &lt;id&gt;</code> is not given, a new identification
will be generated and the generated id will start with an underscore (<code class="docutils literal notranslate">_</code>).
</dd>
</dl>
The currently scheduled list of deferred calls may be retrieved:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_language(DEFER [DIRECTORY &lt;dir&gt;] GET_CALL_IDS &lt;var&gt;)
</pre></div>
</div>
This will store in <code class="docutils literal notranslate">&lt;var&gt;</code> a <a class="reference internal" href="../manual/cmake-language.7.html#cmake-language-lists">semicolon-separated list</a> of deferred call ids. The ids are for the directory scope in which
the calls have been deferred to (i.e. where they will be executed), which can
be different to the scope in which they were created. The <code class="docutils literal notranslate">DIRECTORY</code>
option can be used to specify the scope for which to retrieve the call ids.
If that option is not given, the call ids for the current directory scope will
be returned.
Details of a specific call may be retrieved from its id:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_language(DEFER [DIRECTORY &lt;dir&gt;] GET_CALL &lt;id&gt; &lt;var&gt;)
</pre></div>
</div>
This will store in <code class="docutils literal notranslate">&lt;var&gt;</code> a <a class="reference internal" href="../manual/cmake-language.7.html#cmake-language-lists">semicolon-separated list</a> in which the first element is the name of the command to be
called, and the remaining elements are its unevaluated arguments (any
contained <code class="docutils literal notranslate">;</code> characters are included literally and cannot be distinguished
from multiple arguments). If multiple calls are scheduled with the same id,
this retrieves the first one. If no call is scheduled with the given id in
the specified <code class="docutils literal notranslate">DIRECTORY</code> scope (or the current directory scope if no
<code class="docutils literal notranslate">DIRECTORY</code> option is given), this stores an empty string in the variable.
Deferred calls may be canceled by their id:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_language(DEFER [DIRECTORY &lt;dir&gt;] CANCEL_CALL &lt;id&gt;...)
</pre></div>
</div>
This cancels all deferred calls matching any of the given ids in the specified
<code class="docutils literal notranslate">DIRECTORY</code> scope (or the current directory scope if no <code class="docutils literal notranslate">DIRECTORY</code> option
is given). Unknown ids are silently ignored.
<section id="deferred-call-examples">
<h3>Deferred Call Examples<a class="headerlink" href="#deferred-call-examples" title="Permalink to this heading">¶</a></h3>
For example, the code:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_language(DEFER CALL message &quot;${deferred_message}&quot;)
cmake_language(DEFER ID_VAR id CALL message &quot;Canceled Message&quot;)
cmake_language(DEFER CANCEL_CALL ${id})
message(&quot;Immediate Message&quot;)
set(deferred_message &quot;Deferred Message&quot;)
</pre></div>
</div>
prints:
<div class="highlight-none notranslate"><div class="highlight"><pre>Immediate Message
Deferred Message
</pre></div>
</div>
The <code class="docutils literal notranslate">Cancelled Message</code> is never printed because its command is
canceled. The <code class="docutils literal notranslate">deferred_message</code> variable reference is not evaluated
until the call site, so it can be set after the deferred call is scheduled.
In order to evaluate variable references immediately when scheduling a
deferred call, wrap it using <code class="docutils literal notranslate">cmake_language(EVAL)</code>. However, note that
arguments will be re-evaluated in the deferred call, though that can be
avoided by using bracket arguments. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(deferred_message &quot;Deferred Message 1&quot;)
set(re_evaluated [[${deferred_message}]])
cmake_language(EVAL CODE &quot;
 cmake_language(DEFER CALL message [[${deferred_message}]])
 cmake_language(DEFER CALL message \&quot;${re_evaluated}\&quot;)
&quot;)
message(&quot;Immediate Message&quot;)
set(deferred_message &quot;Deferred Message 2&quot;)
</pre></div>
</div>
also prints:
<div class="highlight-none notranslate"><div class="highlight"><pre>Immediate Message
Deferred Message 1
Deferred Message 2
</pre></div>
</div>
</section>
</section>
<section id="dependency-providers">
<h2>Dependency Providers<a class="headerlink" href="#dependency-providers" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.24.
</div>
<div class="admonition note">
Note
A high-level introduction to this feature can be found in the
<a class="reference internal" href="../guide/using-dependencies/index.html#dependency-providers-overview">Using Dependencies Guide</a>.
</div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_language(SET_DEPENDENCY_PROVIDER &lt;command&gt;
 SUPPORTED_METHODS &lt;methods&gt;...)
</pre></div>
</div>
When a call is made to <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> or
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a>, the call may be forwarded to a
dependency provider which then has the opportunity to fulfill the request.
If the request is for one of the <code class="docutils literal notranslate">&lt;methods&gt;</code> specified when the provider
was set, CMake calls the provider's <code class="docutils literal notranslate">&lt;command&gt;</code> with a set of
method-specific arguments. If the provider does not fulfill the request,
or if the provider doesn't support the request's method, or no provider
is set, the built-in <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> or
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a> implementation is used to fulfill
the request in the usual way.
One or more of the following values can be specified for the <code class="docutils literal notranslate">&lt;methods&gt;</code>
when setting the provider:
<dl class="simple">
<dt><code class="docutils literal notranslate">FIND_PACKAGE</code></dt><dd>The provider command accepts <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> requests.
</dd>
<dt><code class="docutils literal notranslate">FETCHCONTENT_MAKEAVAILABLE_SERIAL</code></dt><dd>The provider command accepts <a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a>
requests. It expects each dependency to be fed to the provider command
one at a time, not the whole list in one go.
</dd>
</dl>
Only one provider can be set at any point in time. If a provider is already
set when <code class="docutils literal notranslate">cmake_language(SET_DEPENDENCY_PROVIDER)</code> is called, the new
provider replaces the previously set one. The specified <code class="docutils literal notranslate">&lt;command&gt;</code> must
already exist when <code class="docutils literal notranslate">cmake_language(SET_DEPENDENCY_PROVIDER)</code> is called.
As a special case, providing an empty string for the <code class="docutils literal notranslate">&lt;command&gt;</code> and no
<code class="docutils literal notranslate">&lt;methods&gt;</code> will discard any previously set provider.
The dependency provider can only be set while processing one of the files
specified by the <a class="reference internal" href="../variable/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.html#variable:CMAKE_PROJECT_TOP_LEVEL_INCLUDES" title="CMAKE_PROJECT_TOP_LEVEL_INCLUDES"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_PROJECT_TOP_LEVEL_INCLUDES</code></a> variable.
Thus, dependency providers can only be set as part of the first call to
<a class="reference internal" href="project.html#command:project" title="project"><code class="xref cmake cmake-command docutils literal notranslate">project()</code></a>. Calling <code class="docutils literal notranslate">cmake_language(SET_DEPENDENCY_PROVIDER)</code>
outside of that context will result in an error.
<div class="admonition note">
Note
The choice of dependency provider should always be under the user's control.
As a convenience, a project may choose to provide a file that users can
list in their <a class="reference internal" href="../variable/CMAKE_PROJECT_TOP_LEVEL_INCLUDES.html#variable:CMAKE_PROJECT_TOP_LEVEL_INCLUDES" title="CMAKE_PROJECT_TOP_LEVEL_INCLUDES"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_PROJECT_TOP_LEVEL_INCLUDES</code></a> variable, but
the use of such a file should always be the user's choice.
</div>
<section id="provider-commands">
<h3>Provider commands<a class="headerlink" href="#provider-commands" title="Permalink to this heading">¶</a></h3>
Providers define a single <code class="docutils literal notranslate">&lt;command&gt;</code> to accept requests. The name of
the command should be specific to that provider, not something overly
generic that another provider might also use. This enables users to compose
different providers in their own custom provider. The recommended form is
<code class="docutils literal notranslate">xxx_provide_dependency()</code>, where <code class="docutils literal notranslate">xxx</code> is the provider-specific part
(e.g. <code class="docutils literal notranslate">vcpkg_provide_dependency()</code>, <code class="docutils literal notranslate">conan_provide_dependency()</code>,
<code class="docutils literal notranslate">ourcompany_provide_dependency()</code>, and so on).
<div class="highlight-cmake notranslate"><div class="highlight"><pre>xxx_provide_dependency(&lt;method&gt; [&lt;method-specific-args&gt;...])
</pre></div>
</div>
Because some methods expect certain variables to be set in the calling scope,
the provider command should typically be implemented as a macro rather than a
function. This ensures it does not introduce a new variable scope.
The arguments CMake passes to the dependency provider depend on the type of
request. The first argument is always the method, and it will only ever
be one of the <code class="docutils literal notranslate">&lt;methods&gt;</code> that was specified when setting the provider.
<dl>
<dt><code class="docutils literal notranslate">FIND_PACKAGE</code></dt><dd>The <code class="docutils literal notranslate">&lt;method-specific-args&gt;</code> will be everything passed to the
<a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> call that requested the dependency. The first of
these <code class="docutils literal notranslate">&lt;method-specific-args&gt;</code> will therefore always be the name of the
dependency. Dependency names are case-sensitive for this method because
<a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> treats them case-sensitively too.
If the provider command fulfills the request, it must set the same variable
that <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> expects to be set. For a dependency named
<code class="docutils literal notranslate">depName</code>, the provider must set <code class="docutils literal notranslate">depName_FOUND</code> to true if it fulfilled
the request. If the provider returns without setting this variable, CMake
will assume the request was not fulfilled and will fall back to the
built-in implementation.
If the provider needs to call the built-in <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a>
implementation as part of its processing, it can do so by including the
<code class="docutils literal notranslate">BYPASS_PROVIDER</code> keyword as one of the arguments.
</dd>
<dt><code class="docutils literal notranslate">FETCHCONTENT_MAKEAVAILABE_SERIAL</code></dt><dd>The <code class="docutils literal notranslate">&lt;method-specific-args&gt;</code> will be everything passed to the
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_declare" title="fetchcontent_declare"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_Declare()</code></a> call that corresponds to the requested
dependency, with the following exceptions:
<ul class="simple">
<li>If <code class="docutils literal notranslate">SOURCE_DIR</code> or <code class="docutils literal notranslate">BINARY_DIR</code> were not part of the original
declared arguments, they will be added with their default values.</li>
<li>If <a class="reference internal" href="../module/FetchContent.html#variable:FETCHCONTENT_TRY_FIND_PACKAGE_MODE" title="FETCHCONTENT_TRY_FIND_PACKAGE_MODE"><code class="xref cmake cmake-variable docutils literal notranslate">FETCHCONTENT_TRY_FIND_PACKAGE_MODE</code></a> is set to <code class="docutils literal notranslate">NEVER</code>,
any <code class="docutils literal notranslate">FIND_PACKAGE_ARGS</code> will be omitted.</li>
<li>The <code class="docutils literal notranslate">OVERRIDE_FIND_PACKAGE</code> keyword is always omitted.</li>
</ul>
The first of the <code class="docutils literal notranslate">&lt;method-specific-args&gt;</code> will always be the name of the
dependency. Dependency names are case-insensitive for this method because
<a class="reference internal" href="../module/FetchContent.html#module:FetchContent" title="FetchContent"><code class="xref cmake cmake-module docutils literal notranslate">FetchContent</code></a> also treats them case-insensitively.
If the provider fulfills the request, it should call
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_setpopulated" title="fetchcontent_setpopulated"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_SetPopulated()</code></a>, passing the name of the dependency as
the first argument. The <code class="docutils literal notranslate">SOURCE_DIR</code> and <code class="docutils literal notranslate">BINARY_DIR</code> arguments to that
command should only be given if the provider makes the dependency's source
and build directories available in exactly the same way as the built-in
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a> command.
If the provider returns without calling <a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_setpopulated" title="fetchcontent_setpopulated"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_SetPopulated()</code></a>
for the named dependency, CMake will assume the request was not fulfilled
and will fall back to the built-in implementation.
Note that empty arguments may be significant for this method (e.g. an empty
string following a <code class="docutils literal notranslate">GIT_SUBMODULES</code> keyword). Therefore, if forwarding
these arguments on to another command, extra care must be taken to avoid such
arguments being silently dropped.
If <code class="docutils literal notranslate">FETCHCONTENT_SOURCE_DIR_&lt;uppercaseDepName&gt;</code> is set, then the
dependency provider will never see requests for the <code class="docutils literal notranslate">&lt;depName&gt;</code> dependency
for this method. When the user sets such a variable, they are explicitly
overriding where to get that dependency from and are taking on the
responsibility that their overriding version meets any requirements for that
dependency and is compatible with whatever else in the project uses it.
Depending on the value of <a class="reference internal" href="../module/FetchContent.html#variable:FETCHCONTENT_TRY_FIND_PACKAGE_MODE" title="FETCHCONTENT_TRY_FIND_PACKAGE_MODE"><code class="xref cmake cmake-variable docutils literal notranslate">FETCHCONTENT_TRY_FIND_PACKAGE_MODE</code></a>
and whether the <code class="docutils literal notranslate">OVERRIDE_FIND_PACKAGE</code> option was given to
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_declare" title="fetchcontent_declare"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_Declare()</code></a>, having
<code class="docutils literal notranslate">FETCHCONTENT_SOURCE_DIR_&lt;uppercaseDepName&gt;</code> set may also prevent the
dependency provider from seeing requests for a <code class="docutils literal notranslate">find_package(depName)</code>
call too.
</dd>
</dl>
</section>
<section id="provider-examples">
<h3>Provider Examples<a class="headerlink" href="#provider-examples" title="Permalink to this heading">¶</a></h3>
This first example only intercepts <a class="reference internal" href="find_package.html#command:find_package" title="find_package"><code class="xref cmake cmake-command docutils literal notranslate">find_package()</code></a> calls. The
provider command runs an external tool which copies the relevant artifacts
into a provider-specific directory, if that tool knows about the dependency.
It then relies on the built-in implementation to then find those artifacts.
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a> calls would not go through the provider.
<div class="literal-block-wrapper docutils container" id="id2">
<div class="code-block-caption">mycomp_provider.cmake<a class="headerlink" href="#id2" title="Permalink to this code">¶</a></div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre># Always ensure we have the policy settings this provider expects
cmake_minimum_required(VERSION 3.24)

set(MYCOMP_PROVIDER_INSTALL_DIR ${CMAKE_BINARY_DIR}/mycomp_packages
 CACHE PATH &quot;The directory this provider installs packages to&quot;
)
# Tell the built-in implementation to look in our area first, unless
# the find_package() call uses NO_..._PATH options to exclude it
list(APPEND CMAKE_MODULE_PATH ${MYCOMP_PROVIDER_INSTALL_DIR}/cmake)
list(APPEND CMAKE_PREFIX_PATH ${MYCOMP_PROVIDER_INSTALL_DIR})

macro(mycomp_provide_dependency method package_name)
 execute_process(
 COMMAND some_tool ${package_name} --installdir ${MYCOMP_PROVIDER_INSTALL_DIR}
 COMMAND_ERROR_IS_FATAL ANY
 )
endmacro()

cmake_language(
 SET_DEPENDENCY_PROVIDER mycomp_provide_dependency
 SUPPORTED_METHODS FIND_PACKAGE
)
</pre></div>
</div>
</div>
The user would then typically use the above file like so:
<div class="highlight-none notranslate"><div class="highlight"><pre>cmake -DCMAKE_PROJECT_TOP_LEVEL_INCLUDES=/path/to/mycomp_provider.cmake ...
</pre></div>
</div>
The next example demonstrates a provider that accepts both methods, but
only handles one specific dependency. It enforces providing Google Test
using <a class="reference internal" href="../module/FetchContent.html#module:FetchContent" title="FetchContent"><code class="xref cmake cmake-module docutils literal notranslate">FetchContent</code></a>, but leaves all other dependencies to be
fulfilled by CMake's built-in implementation. It accepts a few different
names, which demonstrates one way of working around projects that hard-code
an unusual or undesirable way of adding this particular dependency to the
build. The example also demonstrates how to use the <a class="reference internal" href="list.html#command:list" title="list"><code class="xref cmake cmake-command docutils literal notranslate">list()</code></a> command
to preserve variables that may be overwritten by a call to
<a class="reference internal" href="../module/FetchContent.html#command:fetchcontent_makeavailable" title="fetchcontent_makeavailable"><code class="xref cmake cmake-command docutils literal notranslate">FetchContent_MakeAvailable()</code></a>.
<div class="literal-block-wrapper docutils container" id="id3">
<div class="code-block-caption">mycomp_provider.cmake<a class="headerlink" href="#id3" title="Permalink to this code">¶</a></div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>cmake_minimum_required(VERSION 3.24)

# Because we declare this very early, it will take precedence over any
# details the project might declare later for the same thing
include(FetchContent)
FetchContent_Declare(
 googletest
 GIT_REPOSITORY https://github.com/google/googletest.git
 GIT_TAG e2239ee6043f73722e7aa812a459f54a28552929 # release-1.11.0
)

# Both FIND_PACKAGE and FETCHCONTENT_MAKEAVAILABLE_SERIAL methods provide
# the package or dependency name as the first method-specific argument.
macro(mycomp_provide_dependency method dep_name)
 if(&quot;${dep_name}&quot; MATCHES &quot;^(gtest|googletest)$&quot;)
 # Save our current command arguments in case we are called recursively
 list(APPEND mycomp_provider_args ${method} ${dep_name})

# This will forward to the built-in FetchContent implementation,
 # which detects a recursive call for the same thing and avoids calling
 # the provider again if dep_name is the same as the current call.
 FetchContent_MakeAvailable(googletest)

# Restore our command arguments
 list(POP_BACK mycomp_provider_args dep_name method)

# Tell the caller we fulfilled the request
 if(&quot;${method}&quot; STREQUAL &quot;FIND_PACKAGE&quot;)
 # We need to set this if we got here from a find_package() call
 # since we used a different method to fulfill the request.
 # This example assumes projects only use the gtest targets,
 # not any of the variables the FindGTest module may define.
 set(${dep_name}_FOUND TRUE)
 elseif(NOT &quot;${dep_name}&quot; STREQUAL &quot;googletest&quot;)
 # We used the same method, but were given a different name to the
 # one we populated with. Tell the caller about the name it used.
 FetchContent_SetPopulated(${dep_name}
 SOURCE_DIR &quot;${googletest_SOURCE_DIR}&quot;
 BINARY_DIR &quot;${googletest_BINARY_DIR}&quot;
 )
 endif()
 endif()
endmacro()

macro(mycomp_provide_dependency method)
 find_package(${ARGN} BYPASS_PROVIDER QUIET)
endmacro()

cmake_language(
 SET_DEPENDENCY_PROVIDER mycomp_provide_dependency
 SUPPORTED_METHODS FIND_PACKAGE
)
</pre></div>
</div>
</div>
</section>
</section>
<section id="getting-current-message-log-level">
<h2>Getting current message log level<a class="headerlink" href="#getting-current-message-log-level" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.25.
</div>
<div class="highlight-cmake notranslate" id="query-message-log-level"><div class="highlight"><pre>cmake_language(GET_MESSAGE_LOG_LEVEL &lt;output_variable&gt;)
</pre></div>
</div>
Writes the current <a class="reference internal" href="message.html#command:message" title="message"><code class="xref cmake cmake-command docutils literal notranslate">message()</code></a> logging level
into the given <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
See <a class="reference internal" href="message.html#command:message" title="message"><code class="xref cmake cmake-command docutils literal notranslate">message()</code></a> for the possible logging levels.
The current message logging level can be set either using the
<a class="reference internal" href="../manual/cmake.1.html#cmdoption-cmake-log-level"><code class="xref std std-option docutils literal notranslate">--log-level</code></a>
command line option of the <a class="reference internal" href="../manual/cmake.1.html#manual:cmake(1)" title="cmake(1)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake(1)</code></a> program or using
the <a class="reference internal" href="../variable/CMAKE_MESSAGE_LOG_LEVEL.html#variable:CMAKE_MESSAGE_LOG_LEVEL" title="CMAKE_MESSAGE_LOG_LEVEL"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MESSAGE_LOG_LEVEL</code></a> variable.
If both the command line option and the variable are set, the command line
option takes precedence. If neither are set, the default logging level
is returned.
</section>
</section>

<div class="clearer"></div>
 </div>
 </div>
 </div>
 <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
 <div class="sphinxsidebarwrapper">
 <div>
 <h3><a href="../index.html">Table of Contents</a></h3>
 <ul>
<li><a class="reference internal" href="#">cmake_language</a><ul>
<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
<li><a class="reference internal" href="#introduction">Introduction</a></li>
<li><a class="reference internal" href="#calling-commands">Calling Commands</a></li>
<li><a class="reference internal" href="#evaluating-code">Evaluating Code</a></li>
<li><a class="reference internal" href="#deferring-calls">Deferring Calls</a><ul>
<li><a class="reference internal" href="#deferred-call-examples">Deferred Call Examples</a></li>
</ul>
</li>
<li><a class="reference internal" href="#dependency-providers">Dependency Providers</a><ul>
<li><a class="reference internal" href="#provider-commands">Provider commands</a></li>
<li><a class="reference internal" href="#provider-examples">Provider Examples</a></li>
</ul>
</li>
<li><a class="reference internal" href="#getting-current-message-log-level">Getting current message log level</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="cmake_host_system_information.html"
 title="previous chapter">cmake_host_system_information</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="cmake_minimum_required.html"
 title="next chapter">cmake_minimum_required</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/cmake_language.rst.txt"
 rel="nofollow">Show Source</a></li>
 </ul>
 </div>
<div id="searchbox" style="display: none" role="search">
 <h3 id="searchlabel">Quick search</h3>
 <div class="searchformwrapper">
 <form class="search" action="../search.html" method="get">
 <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
 <input type="submit" value="Go" />
 </form>
 </div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
 </div>
 </div>
 <div class="clearer"></div>
 </div>
 <div class="related" role="navigation" aria-label="related navigation">
 <h3>Navigation</h3>
 <ul>
 <li class="right" style="margin-right: 10px">
 <a href="../genindex.html" title="General Index"
 >index</a></li>
 <li class="right" >
 <a href="cmake_minimum_required.html" title="cmake_minimum_required"
 >next</a> |</li>
 <li class="right" >
 <a href="cmake_host_system_information.html" title="cmake_host_system_information"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">cmake_language</a></li> 
 </ul>
 </div>

<div class="footer" role="contentinfo">
 &#169; Copyright 2000-2023 Kitware, Inc. and Contributors.
 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 5.0.2.
 </div>
 </body>
</html>