OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 ccmake.1.html	44.19 KB	04/04/2023 07:05:08 PM	rw-r--r--
📄 cmake-buildsystem.7.html	161.14 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-commands.7.html	21.66 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-compile-features.7.html	46.17 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-configure-log.7.html	35.93 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-developer.7.html	60.56 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-env-variables.7.html	15.36 KB	04/04/2023 07:05:09 PM	rw-r--r--
📄 cmake-file-api.7.html	174.79 KB	04/04/2023 07:05:10 PM	rw-r--r--
📄 cmake-generator-expressions.7.html	229.68 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-generators.7.html	16.07 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-gui.1.html	27.62 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-language.7.html	67.9 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-modules.7.html	37.63 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-packages.7.html	84.94 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-policies.7.html	48.41 KB	04/04/2023 07:05:11 PM	rw-r--r--
📄 cmake-presets.7.html	122.21 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-properties.7.html	80.47 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-qt.7.html	47.92 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-server.7.html	5.39 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-toolchains.7.html	92.74 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake-variables.7.html	105.71 KB	04/04/2023 07:05:12 PM	rw-r--r--
📄 cmake.1.html	170.8 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack-generators.7.html	7.54 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 cpack.1.html	39.49 KB	04/04/2023 07:05:13 PM	rw-r--r--
📄 ctest.1.html	230.72 KB	04/04/2023 07:05:13 PM	rw-r--r--

Editing: cmake-generator-expressions.7.html

<!DOCTYPE html>

<title>cmake-generator-expressions(7) &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-generators.7.html" title="cmake-generators(7)"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="cmake-file-api.7.html" title="cmake-file-api(7)"
 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-this"><a href="">cmake-generator-expressions(7)</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="cmake-generator-expressions-7">
<h1><a class="toc-backref" href="#id1" role="doc-backlink">cmake-generator-expressions(7)</a><a class="headerlink" href="#cmake-generator-expressions-7" title="Permalink to this heading">¶</a></h1>
<nav class="contents" id="contents">
Contents
<ul class="simple">
<li><a class="reference internal" href="#cmake-generator-expressions-7" id="id1">cmake-generator-expressions(7)</a>
<ul>
<li><a class="reference internal" href="#introduction" id="id2">Introduction</a></li>
<li><a class="reference internal" href="#whitespace-and-quoting" id="id3">Whitespace And Quoting</a></li>
<li><a class="reference internal" href="#debugging" id="id4">Debugging</a></li>
<li><a class="reference internal" href="#generator-expression-reference" id="id5">Generator Expression Reference</a>
<ul>
<li><a class="reference internal" href="#conditional-expressions" id="id6">Conditional Expressions</a></li>
<li><a class="reference internal" href="#logical-operators" id="id7">Logical Operators</a></li>
<li><a class="reference internal" href="#primary-comparison-expressions" id="id8">Primary Comparison Expressions</a>
<ul>
<li><a class="reference internal" href="#string-comparisons" id="id9">String Comparisons</a></li>
<li><a class="reference internal" href="#version-comparisons" id="id10">Version Comparisons</a></li>
</ul>
</li>
<li><a class="reference internal" href="#string-transformations" id="id11">String Transformations</a></li>
<li><a class="reference internal" href="#list-expressions" id="id12">List Expressions</a></li>
<li><a class="reference internal" href="#path-expressions" id="id13">Path Expressions</a>
<ul>
<li><a class="reference internal" href="#path-comparisons" id="id14">Path Comparisons</a></li>
<li><a class="reference internal" href="#path-queries" id="id15">Path Queries</a></li>
<li><a class="reference internal" href="#path-decomposition" id="id16">Path Decomposition</a></li>
<li><a class="reference internal" href="#path-transformations" id="id17">Path Transformations</a></li>
<li><a class="reference internal" href="#shell-paths" id="id18">Shell Paths</a></li>
</ul>
</li>
<li><a class="reference internal" href="#configuration-expressions" id="id19">Configuration Expressions</a></li>
<li><a class="reference internal" href="#toolchain-and-language-expressions" id="id20">Toolchain And Language Expressions</a>
<ul>
<li><a class="reference internal" href="#platform" id="id21">Platform</a></li>
<li><a class="reference internal" href="#compiler-version" id="id22">Compiler Version</a></li>
<li><a class="reference internal" href="#compiler-language-and-id" id="id23">Compiler Language And ID</a></li>
<li><a class="reference internal" href="#compile-features" id="id24">Compile Features</a></li>
<li><a class="reference internal" href="#linker-language-and-id" id="id25">Linker Language And ID</a></li>
<li><a class="reference internal" href="#link-features" id="id26">Link Features</a></li>
<li><a class="reference internal" href="#link-context" id="id27">Link Context</a></li>
</ul>
</li>
<li><a class="reference internal" href="#target-dependent-expressions" id="id28">Target-Dependent Expressions</a></li>
<li><a class="reference internal" href="#export-and-install-expressions" id="id29">Export And Install Expressions</a></li>
<li><a class="reference internal" href="#multi-level-expression-evaluation" id="id30">Multi-level Expression Evaluation</a></li>
<li><a class="reference internal" href="#escaped-characters" id="id31">Escaped Characters</a></li>
<li><a class="reference internal" href="#deprecated-expressions" id="id32">Deprecated Expressions</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</nav>
<section id="introduction">
<h2><a class="toc-backref" href="#id2" role="doc-backlink">Introduction</a><a class="headerlink" href="#introduction" title="Permalink to this heading">¶</a></h2>
Generator expressions are evaluated during build system generation to produce
information specific to each build configuration. They have the form
<code class="docutils literal notranslate">$&lt;...&gt;</code>. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_include_directories(tgt PRIVATE /opt/include/$&lt;CXX_COMPILER_ID&gt;)
</pre></div>
</div>
This would expand to <code class="docutils literal notranslate">/opt/include/GNU</code>, <code class="docutils literal notranslate">/opt/include/Clang</code>, etc.
depending on the C++ compiler used.
Generator expressions are allowed in the context of many target properties,
such as <a class="reference internal" href="../prop_tgt/LINK_LIBRARIES.html#prop_tgt:LINK_LIBRARIES" title="LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARIES</code></a>, <a class="reference internal" href="../prop_tgt/INCLUDE_DIRECTORIES.html#prop_tgt:INCLUDE_DIRECTORIES" title="INCLUDE_DIRECTORIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INCLUDE_DIRECTORIES</code></a>,
<a class="reference internal" href="../prop_tgt/COMPILE_DEFINITIONS.html#prop_tgt:COMPILE_DEFINITIONS" title="COMPILE_DEFINITIONS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">COMPILE_DEFINITIONS</code></a> and others. They may also be used when using
commands to populate those properties, such as <a class="reference internal" href="../command/target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a>,
<a class="reference internal" href="../command/target_include_directories.html#command:target_include_directories" title="target_include_directories"><code class="xref cmake cmake-command docutils literal notranslate">target_include_directories()</code></a>, <a class="reference internal" href="../command/target_compile_definitions.html#command:target_compile_definitions" title="target_compile_definitions"><code class="xref cmake cmake-command docutils literal notranslate">target_compile_definitions()</code></a>
and others. They enable conditional linking, conditional definitions used when
compiling, conditional include directories, and more. The conditions may be
based on the build configuration, target properties, platform information,
or any other queryable information.
Generator expressions can be nested:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_compile_definitions(tgt PRIVATE
 $&lt;$&lt;VERSION_LESS:$&lt;CXX_COMPILER_VERSION&gt;,4.2.0&gt;:OLD_COMPILER&gt;
)
</pre></div>
</div>
The above would expand to <code class="docutils literal notranslate">OLD_COMPILER</code> if the
<a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_VERSION.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_VERSION" title="CMAKE_&lt;LANG&gt;_COMPILER_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_CXX_COMPILER_VERSION</code></a> is less
than 4.2.0.
</section>
<section id="whitespace-and-quoting">
<h2><a class="toc-backref" href="#id3" role="doc-backlink">Whitespace And Quoting</a><a class="headerlink" href="#whitespace-and-quoting" title="Permalink to this heading">¶</a></h2>
Generator expressions are typically parsed after command arguments.
If a generator expression contains spaces, new lines, semicolons or
other characters that may be interpreted as command argument separators,
the whole expression should be surrounded by quotes when passed to a
command. Failure to do so may result in the expression being split and
it may no longer be recognized as a generator expression.
When using <a class="reference internal" href="../command/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> or <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>,
use the <code class="docutils literal notranslate">VERBATIM</code> and <code class="docutils literal notranslate">COMMAND_EXPAND_LISTS</code> options to obtain robust
argument splitting and quoting.
<div class="highlight-cmake notranslate"><div class="highlight"><pre># WRONG: Embedded space will be treated as an argument separator.
# This ends up not being seen as a generator expression at all.
add_custom_target(run_some_tool
 COMMAND some_tool -I$&lt;JOIN:$&lt;TARGET_PROPERTY:tgt,INCLUDE_DIRECTORIES&gt;, -I&gt;
 VERBATIM
)
</pre></div>
</div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre># Better, but still not robust. Quotes prevent the space from splitting the
# expression. However, the tool will receive the expanded value as a single
# argument.
add_custom_target(run_some_tool
 COMMAND some_tool &quot;-I$&lt;JOIN:$&lt;TARGET_PROPERTY:tgt,INCLUDE_DIRECTORIES&gt;, -I&gt;&quot;
 VERBATIM
)
</pre></div>
</div>
<div class="highlight-cmake notranslate"><div class="highlight"><pre># Nearly correct. Using a semicolon to separate arguments and adding the
# COMMAND_EXPAND_LISTS option means that paths with spaces will be handled
# correctly. Quoting the whole expression ensures it is seen as a generator
# expression. But if the target property is empty, we will get a bare -I
# with nothing after it.
add_custom_target(run_some_tool
 COMMAND some_tool &quot;-I$&lt;JOIN:$&lt;TARGET_PROPERTY:tgt,INCLUDE_DIRECTORIES&gt;,;-I&gt;&quot;
 COMMAND_EXPAND_LISTS
 VERBATIM
)
</pre></div>
</div>
Using variables to build up a more complex generator expression is also a
good way to reduce errors and improve readability. The above example can be
improved further like so:
<div class="highlight-cmake notranslate"><div class="highlight"><pre># The $&lt;BOOL:...&gt; check prevents adding anything if the property is empty,
# assuming the property value cannot be one of CMake&#39;s false constants.
set(prop &quot;$&lt;TARGET_PROPERTY:tgt,INCLUDE_DIRECTORIES&gt;&quot;)
add_custom_target(run_some_tool
 COMMAND some_tool &quot;$&lt;$&lt;BOOL:${prop}&gt;:-I$&lt;JOIN:${prop},;-I&gt;&gt;&quot;
 COMMAND_EXPAND_LISTS
 VERBATIM
)
</pre></div>
</div>
A common mistake is to try to split a generator expression across multiple
lines with indenting:
<div class="highlight-cmake notranslate"><div class="highlight"><pre># WRONG: New lines and spaces all treated as argument separators, so the
# generator expression is split and not recognized correctly.
target_compile_definitions(tgt PRIVATE
 $&lt;$&lt;AND:
 $&lt;CXX_COMPILER_ID:GNU&gt;,
 $&lt;VERSION_GREATER_EQUAL:$&lt;CXX_COMPILER_VERSION&gt;,5&gt;
 &gt;:HAVE_5_OR_LATER&gt;
)
</pre></div>
</div>
Again, use helper variables with well-chosen names to build up a readable
expression instead:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(is_gnu &quot;$&lt;CXX_COMPILER_ID:GNU&gt;&quot;)
set(v5_or_later &quot;$&lt;VERSION_GREATER_EQUAL:$&lt;CXX_COMPILER_VERSION&gt;,5&gt;&quot;)
set(meet_requirements &quot;$&lt;AND:${is_gnu},${v5_or_later}&gt;&quot;)
target_compile_definitions(tgt PRIVATE
 &quot;$&lt;${meet_requirements}:HAVE_5_OR_LATER&gt;&quot;
)
</pre></div>
</div>
</section>
<section id="debugging">
<h2><a class="toc-backref" href="#id4" role="doc-backlink">Debugging</a><a class="headerlink" href="#debugging" title="Permalink to this heading">¶</a></h2>
Since generator expressions are evaluated during generation of the buildsystem,
and not during processing of <code class="docutils literal notranslate">CMakeLists.txt</code> files, it is not possible to
inspect their result with the <a class="reference internal" href="../command/message.html#command:message" title="message"><code class="xref cmake cmake-command docutils literal notranslate">message()</code></a> command. One possible way
to generate debug messages is to add a custom target:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_custom_target(genexdebug COMMAND ${CMAKE_COMMAND} -E echo &quot;$&lt;...&gt;&quot;)
</pre></div>
</div>
After running cmake, you can then build the <code class="docutils literal notranslate">genexdebug</code> target to print
the result of the <code class="docutils literal notranslate">$&lt;...&gt;</code> expression (i.e. run the command
<a class="reference internal" href="cmake.1.html#cmdoption-cmake-build-t"><code class="xref std std-option docutils literal notranslate">cmake --build ... --target genexdebug</code></a>).
Another way is to write debug messages to a file with <a class="reference internal" href="../command/file.html#command:file" title="file"><code class="xref cmake cmake-command docutils literal notranslate">file(GENERATE)</code></a>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>file(GENERATE OUTPUT filename CONTENT &quot;$&lt;...&gt;&quot;)
</pre></div>
</div>
</section>
<section id="generator-expression-reference">
<h2><a class="toc-backref" href="#id5" role="doc-backlink">Generator Expression Reference</a><a class="headerlink" href="#generator-expression-reference" title="Permalink to this heading">¶</a></h2>
<div class="admonition note">
Note
This reference deviates from most of the CMake documentation in that it
omits angular brackets <code class="docutils literal notranslate">&lt;...&gt;</code> around placeholders like <code class="docutils literal notranslate">condition</code>,
<code class="docutils literal notranslate">string</code>, <code class="docutils literal notranslate">target</code>, etc. This is to prevent an opportunity for those
placeholders to be misinterpreted as generator expressions.
</div>
<section id="conditional-expressions">
<h3><a class="toc-backref" href="#id6" role="doc-backlink">Conditional Expressions</a><a class="headerlink" href="#conditional-expressions" title="Permalink to this heading">¶</a></h3>
A fundamental category of generator expressions relates to conditional logic.
Two forms of conditional generator expressions are supported:
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:condition">
$&lt;condition:true_string&gt;<a class="headerlink" href="#genex:condition" title="Permalink to this definition">¶</a></dt>
<dd>Evaluates to <code class="docutils literal notranslate">true_string</code> if <code class="docutils literal notranslate">condition</code> is <code class="docutils literal notranslate">1</code>, or an empty string
if <code class="docutils literal notranslate">condition</code> evaluates to <code class="docutils literal notranslate">0</code>. Any other value for <code class="docutils literal notranslate">condition</code>
results in an error.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:IF">
$&lt;IF:condition,true_string,false_string&gt;<a class="headerlink" href="#genex:IF" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.8.
</div>
Evaluates to <code class="docutils literal notranslate">true_string</code> if <code class="docutils literal notranslate">condition</code> is <code class="docutils literal notranslate">1</code>, or <code class="docutils literal notranslate">false_string</code>
if <code class="docutils literal notranslate">condition</code> is <code class="docutils literal notranslate">0</code>. Any other value for <code class="docutils literal notranslate">condition</code> results in an
error.
</dd></dl>

Typically, the <code class="docutils literal notranslate">condition</code> is itself a generator expression. For instance,
the following expression expands to <code class="docutils literal notranslate">DEBUG_MODE</code> when the <code class="docutils literal notranslate">Debug</code>
configuration is used, and the empty string for all other configurations:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>$&lt;$&lt;CONFIG:Debug&gt;:DEBUG_MODE&gt;
</pre></div>
</div>
Boolean-like <code class="docutils literal notranslate">condition</code> values other than <code class="docutils literal notranslate">1</code> or <code class="docutils literal notranslate">0</code> can be handled
by wrapping them with the <code class="docutils literal notranslate">$&lt;BOOL:...&gt;</code> generator expression:
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:BOOL">
$&lt;BOOL:string&gt;<a class="headerlink" href="#genex:BOOL" title="Permalink to this definition">¶</a></dt>
<dd>Converts <code class="docutils literal notranslate">string</code> to <code class="docutils literal notranslate">0</code> or <code class="docutils literal notranslate">1</code>. Evaluates to <code class="docutils literal notranslate">0</code> if any of the
following is true:
<ul class="simple">
<li><code class="docutils literal notranslate">string</code> is empty,</li>
<li><code class="docutils literal notranslate">string</code> is a case-insensitive equal of
<code class="docutils literal notranslate">0</code>, <code class="docutils literal notranslate">FALSE</code>, <code class="docutils literal notranslate">OFF</code>, <code class="docutils literal notranslate">N</code>, <code class="docutils literal notranslate">NO</code>, <code class="docutils literal notranslate">IGNORE</code>, or <code class="docutils literal notranslate">NOTFOUND</code>, or</li>
<li><code class="docutils literal notranslate">string</code> ends in the suffix <code class="docutils literal notranslate">-NOTFOUND</code> (case-sensitive).</li>
</ul>
Otherwise evaluates to <code class="docutils literal notranslate">1</code>.
</dd></dl>

The <code class="docutils literal notranslate">$&lt;BOOL:...&gt;</code> generator expression is often used when a <code class="docutils literal notranslate">condition</code>
is provided by a CMake variable:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>$&lt;$&lt;BOOL:${HAVE_SOME_FEATURE}&gt;:-DENABLE_SOME_FEATURE&gt;
</pre></div>
</div>
</section>
<section id="logical-operators">
<h3><a class="toc-backref" href="#id7" role="doc-backlink">Logical Operators</a><a class="headerlink" href="#logical-operators" title="Permalink to this heading">¶</a></h3>
The common boolean logic operators are supported:
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:AND">
$&lt;AND:conditions&gt;<a class="headerlink" href="#genex:AND" title="Permalink to this definition">¶</a></dt>
<dd>where <code class="docutils literal notranslate">conditions</code> is a comma-separated list of boolean expressions,
all of which must evaluate to either <code class="docutils literal notranslate">1</code> or <code class="docutils literal notranslate">0</code>. The whole expression
evaluates to <code class="docutils literal notranslate">1</code> if all conditions are <code class="docutils literal notranslate">1</code>. If any condition is <code class="docutils literal notranslate">0</code>,
the whole expression evaluates to <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OR">
$&lt;OR:conditions&gt;<a class="headerlink" href="#genex:OR" title="Permalink to this definition">¶</a></dt>
<dd>where <code class="docutils literal notranslate">conditions</code> is a comma-separated list of boolean expressions.
all of which must evaluate to either <code class="docutils literal notranslate">1</code> or <code class="docutils literal notranslate">0</code>. The whole expression
evaluates to <code class="docutils literal notranslate">1</code> if at least one of the <code class="docutils literal notranslate">conditions</code> is <code class="docutils literal notranslate">1</code>. If all
<code class="docutils literal notranslate">conditions</code> evaluate to <code class="docutils literal notranslate">0</code>, the whole expression evaluates to <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:NOT">
$&lt;NOT:condition&gt;<a class="headerlink" href="#genex:NOT" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">condition</code> must be <code class="docutils literal notranslate">0</code> or <code class="docutils literal notranslate">1</code>. The result of the expression is
<code class="docutils literal notranslate">0</code> if <code class="docutils literal notranslate">condition</code> is <code class="docutils literal notranslate">1</code>, else <code class="docutils literal notranslate">1</code>.
</dd></dl>

</section>
<section id="primary-comparison-expressions">
<h3><a class="toc-backref" href="#id8" role="doc-backlink">Primary Comparison Expressions</a><a class="headerlink" href="#primary-comparison-expressions" title="Permalink to this heading">¶</a></h3>
CMake supports a variety of generator expressions that compare things.
This section covers the primary and most widely used comparison types.
Other more specific comparison types are documented in their own separate
sections further below.
<section id="string-comparisons">
<h4><a class="toc-backref" href="#id9" role="doc-backlink">String Comparisons</a><a class="headerlink" href="#string-comparisons" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:STREQUAL">
$&lt;STREQUAL:string1,string2&gt;<a class="headerlink" href="#genex:STREQUAL" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">string1</code> and <code class="docutils literal notranslate">string2</code> are equal, else <code class="docutils literal notranslate">0</code>.
The comparison is case-sensitive. For a case-insensitive comparison,
combine with a <a class="reference internal" href="#string-transforming-generator-expressions">string transforming generator expression</a>. For example, the following
evaluates to <code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">${foo}</code> is any of <code class="docutils literal notranslate">BAR</code>, <code class="docutils literal notranslate">Bar</code>, <code class="docutils literal notranslate">bar</code>, etc.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>$&lt;STREQUAL:$&lt;UPPER_CASE:${foo}&gt;,BAR&gt;
</pre></div>
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:EQUAL">
$&lt;EQUAL:value1,value2&gt;<a class="headerlink" href="#genex:EQUAL" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">value1</code> and <code class="docutils literal notranslate">value2</code> are numerically equal, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

</section>
<section id="version-comparisons">
<h4><a class="toc-backref" href="#id10" role="doc-backlink">Version Comparisons</a><a class="headerlink" href="#version-comparisons" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:VERSION_LESS">
$&lt;VERSION_LESS:v1,v2&gt;<a class="headerlink" href="#genex:VERSION_LESS" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">v1</code> is a version less than <code class="docutils literal notranslate">v2</code>, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:VERSION_GREATER">
$&lt;VERSION_GREATER:v1,v2&gt;<a class="headerlink" href="#genex:VERSION_GREATER" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">v1</code> is a version greater than <code class="docutils literal notranslate">v2</code>, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:VERSION_EQUAL">
$&lt;VERSION_EQUAL:v1,v2&gt;<a class="headerlink" href="#genex:VERSION_EQUAL" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">v1</code> is the same version as <code class="docutils literal notranslate">v2</code>, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:VERSION_LESS_EQUAL">
$&lt;VERSION_LESS_EQUAL:v1,v2&gt;<a class="headerlink" href="#genex:VERSION_LESS_EQUAL" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.7.
</div>
<code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">v1</code> is a version less than or equal to <code class="docutils literal notranslate">v2</code>, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:VERSION_GREATER_EQUAL">
$&lt;VERSION_GREATER_EQUAL:v1,v2&gt;<a class="headerlink" href="#genex:VERSION_GREATER_EQUAL" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.7.
</div>
<code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">v1</code> is a version greater than or equal to <code class="docutils literal notranslate">v2</code>, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

</section>
</section>
<section id="string-transformations">
<h3><a class="toc-backref" href="#id11" role="doc-backlink">String Transformations</a><a class="headerlink" href="#string-transformations" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LOWER_CASE">
$&lt;LOWER_CASE:string&gt;<a class="headerlink" href="#genex:LOWER_CASE" title="Permalink to this definition">¶</a></dt>
<dd>Content of <code class="docutils literal notranslate">string</code> converted to lower case.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:UPPER_CASE">
$&lt;UPPER_CASE:string&gt;<a class="headerlink" href="#genex:UPPER_CASE" title="Permalink to this definition">¶</a></dt>
<dd>Content of <code class="docutils literal notranslate">string</code> converted to upper case.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:MAKE_C_IDENTIFIER">
$&lt;MAKE_C_IDENTIFIER:...&gt;<a class="headerlink" href="#genex:MAKE_C_IDENTIFIER" title="Permalink to this definition">¶</a></dt>
<dd>Content of <code class="docutils literal notranslate">...</code> converted to a C identifier. The conversion follows the
same behavior as <a class="reference internal" href="../command/string.html#command:string" title="string"><code class="xref cmake cmake-command docutils literal notranslate">string(MAKE_C_IDENTIFIER)</code></a>.
</dd></dl>

</section>
<section id="list-expressions">
<h3><a class="toc-backref" href="#id12" role="doc-backlink">List Expressions</a><a class="headerlink" href="#list-expressions" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:IN_LIST">
$&lt;IN_LIST:string,list&gt;<a class="headerlink" href="#genex:IN_LIST" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.12.
</div>
<code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">string</code> is an item in the semicolon-separated <code class="docutils literal notranslate">list</code>, else <code class="docutils literal notranslate">0</code>.
It uses case-sensitive comparisons.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:JOIN">
$&lt;JOIN:list,string&gt;<a class="headerlink" href="#genex:JOIN" title="Permalink to this definition">¶</a></dt>
<dd>Joins the list with the content of <code class="docutils literal notranslate">string</code> inserted between each item.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:REMOVE_DUPLICATES">
$&lt;REMOVE_DUPLICATES:list&gt;<a class="headerlink" href="#genex:REMOVE_DUPLICATES" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Removes duplicated items in the given <code class="docutils literal notranslate">list</code>. The relative order of items
is preserved, but if duplicates are encountered, only the first instance is
preserved.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:FILTER">
$&lt;FILTER:list,INCLUDE|EXCLUDE,regex&gt;<a class="headerlink" href="#genex:FILTER" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Includes or removes items from <code class="docutils literal notranslate">list</code> that match the regular expression
<code class="docutils literal notranslate">regex</code>.
</dd></dl>

</section>
<section id="path-expressions">
<h3><a class="toc-backref" href="#id13" role="doc-backlink">Path Expressions</a><a class="headerlink" href="#path-expressions" title="Permalink to this heading">¶</a></h3>
Most of the expressions in this section are closely associated with the
<a class="reference internal" href="../command/cmake_path.html#command:cmake_path" title="cmake_path"><code class="xref cmake cmake-command docutils literal notranslate">cmake_path()</code></a> command, providing the same capabilities, but in
the form of a generator expression.
For all generator expressions in this section, paths are expected to be in
cmake-style format. The <a class="reference internal" href="#genex-path-cmake-path">$&lt;PATH:CMAKE_PATH&gt;</a>
generator expression can be used to convert a native path to a cmake-style
one.
<section id="path-comparisons">
<h4><a class="toc-backref" href="#id14" role="doc-backlink">Path Comparisons</a><a class="headerlink" href="#path-comparisons" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:PATH_EQUAL">
$&lt;PATH_EQUAL:path1,path2&gt;<a class="headerlink" href="#genex:PATH_EQUAL" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Compares the lexical representations of two paths. No normalization is
performed on either path. Returns <code class="docutils literal notranslate">1</code> if the paths are equal, <code class="docutils literal notranslate">0</code>
otherwise.
See <a class="reference internal" href="../command/cmake_path.html#path-compare">cmake_path(COMPARE)</a> for more details.
</dd></dl>

</section>
<section id="path-queries">
<h4><a class="toc-backref" href="#id15" role="doc-backlink">Path Queries</a><a class="headerlink" href="#path-queries" title="Permalink to this heading">¶</a></h4>
These expressions provide the generation-time capabilities equivalent to the
<a class="reference internal" href="../command/cmake_path.html#path-query">Query</a> options of the <a class="reference internal" href="../command/cmake_path.html#command:cmake_path" title="cmake_path"><code class="xref cmake cmake-command docutils literal notranslate">cmake_path()</code></a> command.
All paths are expected to be in cmake-style format.
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:PATH">
$&lt;PATH:HAS_*,path&gt;<a class="headerlink" href="#genex:PATH" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
The following operations return <code class="docutils literal notranslate">1</code> if the particular path component is
present, <code class="docutils literal notranslate">0</code> otherwise. See <a class="reference internal" href="../command/cmake_path.html#path-structure-and-terminology">Path Structure And Terminology</a> for the
meaning of each path component.
<div class="highlight-none notranslate"><div class="highlight"><pre>$&lt;PATH:HAS_ROOT_NAME,path&gt;
$&lt;PATH:HAS_ROOT_DIRECTORY,path&gt;
$&lt;PATH:HAS_ROOT_PATH,path&gt;
$&lt;PATH:HAS_FILENAME,path&gt;
$&lt;PATH:HAS_EXTENSION,path&gt;
$&lt;PATH:HAS_STEM,path&gt;
$&lt;PATH:HAS_RELATIVE_PART,path&gt;
$&lt;PATH:HAS_PARENT_PATH,path&gt;
</pre></div>
</div>
Note the following special cases:
<ul class="simple">
<li>For <code class="docutils literal notranslate">HAS_ROOT_PATH</code>, a true result will only be returned if at least one
of <code class="docutils literal notranslate">root-name</code> or <code class="docutils literal notranslate">root-directory</code> is non-empty.</li>
<li>For <code class="docutils literal notranslate">HAS_PARENT_PATH</code>, the root directory is also considered to have a
parent, which will be itself. The result is true except if the path
consists of just a <a class="reference internal" href="../command/cmake_path.html#filename-def">filename</a>.</li>
</ul>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:IS_ABSOLUTE,path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">1</code> if the path is <a class="reference internal" href="../command/cmake_path.html#is-absolute">absolute</a>, <code class="docutils literal notranslate">0</code> otherwise.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:IS_RELATIVE,path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
This will return the opposite of <code class="docutils literal notranslate">IS_ABSOLUTE</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:IS_PREFIX[,NORMALIZE],path,input&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">path</code> is the prefix of <code class="docutils literal notranslate">input</code>, <code class="docutils literal notranslate">0</code> otherwise.
When the <code class="docutils literal notranslate">NORMALIZE</code> option is specified, <code class="docutils literal notranslate">path</code> and <code class="docutils literal notranslate">input</code> are
<a class="reference internal" href="../command/cmake_path.html#normalization">normalized</a> before the check.
</dd></dl>

</section>
<section id="path-decomposition">
<h4><a class="toc-backref" href="#id16" role="doc-backlink">Path Decomposition</a><a class="headerlink" href="#path-decomposition" title="Permalink to this heading">¶</a></h4>
These expressions provide the generation-time capabilities equivalent to the
<a class="reference internal" href="../command/cmake_path.html#path-decomposition">Decomposition</a> options of the <a class="reference internal" href="../command/cmake_path.html#command:cmake_path" title="cmake_path"><code class="xref cmake cmake-command docutils literal notranslate">cmake_path()</code></a>
command. All paths are expected to be in cmake-style format.
<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:GET_*,...&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
The following operations retrieve a different component or group of
components from a path. See <a class="reference internal" href="../command/cmake_path.html#path-structure-and-terminology">Path Structure And Terminology</a> for the
meaning of each path component.
<div class="highlight-none notranslate"><div class="highlight"><pre>$&lt;PATH:GET_ROOT_NAME,path&gt;
$&lt;PATH:GET_ROOT_DIRECTORY,path&gt;
$&lt;PATH:GET_ROOT_PATH,path&gt;
$&lt;PATH:GET_FILENAME,path&gt;
$&lt;PATH:GET_EXTENSION[,LAST_ONLY],path&gt;
$&lt;PATH:GET_STEM[,LAST_ONLY],path&gt;
$&lt;PATH:GET_RELATIVE_PART,path&gt;
$&lt;PATH:GET_PARENT_PATH,path&gt;
</pre></div>
</div>
If a requested component is not present in the path, an empty string is
returned.
</dd></dl>

</section>
<section id="path-transformations">
<h4><a class="toc-backref" href="#id17" role="doc-backlink">Path Transformations</a><a class="headerlink" href="#path-transformations" title="Permalink to this heading">¶</a></h4>
These expressions provide the generation-time capabilities equivalent to the
<a class="reference internal" href="../command/cmake_path.html#path-modification">Modification</a> and <a class="reference internal" href="../command/cmake_path.html#path-generation">Generation</a>
options of the <a class="reference internal" href="../command/cmake_path.html#command:cmake_path" title="cmake_path"><code class="xref cmake cmake-command docutils literal notranslate">cmake_path()</code></a> command. All paths are expected to be
in cmake-style format.
<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:CMAKE_PATH[,NORMALIZE],path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code>. If <code class="docutils literal notranslate">path</code> is a native path, it is converted into a
cmake-style path with forward-slashes (<code class="docutils literal notranslate">/</code>). On Windows, the long filename
marker is taken into account.
When the <code class="docutils literal notranslate">NORMALIZE</code> option is specified, the path is <a class="reference internal" href="../command/cmake_path.html#normalization">normalized</a> after the conversion.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:APPEND,path,input,...&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns all the <code class="docutils literal notranslate">input</code> arguments appended to <code class="docutils literal notranslate">path</code> using <code class="docutils literal notranslate">/</code> as the
<code class="docutils literal notranslate">directory-separator</code>. Depending on the <code class="docutils literal notranslate">input</code>, the value of <code class="docutils literal notranslate">path</code>
may be discarded.
See <a class="reference internal" href="../command/string.html#append">cmake_path(APPEND)</a> for more details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:REMOVE_FILENAME,path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> with filename component (as returned by
<code class="docutils literal notranslate">$&lt;PATH:GET_FILENAME&gt;</code>) removed. After removal, any trailing
<code class="docutils literal notranslate">directory-separator</code> is left alone, if present.
See <a class="reference internal" href="../command/cmake_path.html#remove-filename">cmake_path(REMOVE_FILENAME)</a> for more details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:REPLACE_FILENAME,path,input&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> with the filename component replaced by <code class="docutils literal notranslate">input</code>. If
<code class="docutils literal notranslate">path</code> has no filename component (i.e. <code class="docutils literal notranslate">$&lt;PATH:HAS_FILENAME&gt;</code> returns
<code class="docutils literal notranslate">0</code>), <code class="docutils literal notranslate">path</code> is unchanged.
See <a class="reference internal" href="../command/cmake_path.html#replace-filename">cmake_path(REPLACE_FILENAME)</a> for more details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:REMOVE_EXTENSION[,LAST_ONLY],path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> with the <a class="reference internal" href="../command/cmake_path.html#extension-def">extension</a> removed, if any.
See <a class="reference internal" href="../command/cmake_path.html#remove-extension">cmake_path(REMOVE_EXTENSION)</a> for more details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:REPLACE_EXTENSION[,LAST_ONLY],path,input&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> with the <a class="reference internal" href="../command/cmake_path.html#extension-def">extension</a> replaced by
<code class="docutils literal notranslate">input</code>, if any.
See <a class="reference internal" href="../command/cmake_path.html#replace-extension">cmake_path(REPLACE_EXTENSION)</a> for more details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:NORMAL_PATH,path&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> normalized according to the steps described in
<a class="reference internal" href="../command/cmake_path.html#normalization">Normalization</a>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:RELATIVE_PATH,path,base_directory&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code>, modified to make it relative to the <code class="docutils literal notranslate">base_directory</code>
argument.
See <a class="reference internal" href="../command/cmake_path.html#cmake-path-relative-path">cmake_path(RELATIVE_PATH)</a> for more
details.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PATH:ABSOLUTE_PATH[,NORMALIZE],path,base_directory&gt;</dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Returns <code class="docutils literal notranslate">path</code> as absolute. If <code class="docutils literal notranslate">path</code> is a relative path
(<code class="docutils literal notranslate">$&lt;PATH:IS_RELATIVE&gt;</code> returns <code class="docutils literal notranslate">1</code>), it is evaluated relative to the
given base directory specified by <code class="docutils literal notranslate">base_directory</code> argument.
When the <code class="docutils literal notranslate">NORMALIZE</code> option is specified, the path is
<a class="reference internal" href="../command/cmake_path.html#normalization">normalized</a> after the path computation.
See <a class="reference internal" href="../command/cmake_path.html#absolute-path">cmake_path(ABSOLUTE_PATH)</a> for more details.
</dd></dl>

</section>
<section id="shell-paths">
<h4><a class="toc-backref" href="#id18" role="doc-backlink">Shell Paths</a><a class="headerlink" href="#shell-paths" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:SHELL_PATH">
$&lt;SHELL_PATH:...&gt;<a class="headerlink" href="#genex:SHELL_PATH" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.4.
</div>
Content of <code class="docutils literal notranslate">...</code> converted to shell path style. For example, slashes are
converted to backslashes in Windows shells and drive letters are converted
to posix paths in MSYS shells. The <code class="docutils literal notranslate">...</code> must be an absolute path.
<div class="versionadded">
New in version 3.14: The <code class="docutils literal notranslate">...</code> may be a <a class="reference internal" href="cmake-language.7.html#cmake-language-lists">semicolon-separated list</a>
of paths, in which case each path is converted individually and a result
list is generated using the shell path separator (<code class="docutils literal notranslate">:</code> on POSIX and
<code class="docutils literal notranslate">;</code> on Windows). Be sure to enclose the argument containing this genex
in double quotes in CMake source code so that <code class="docutils literal notranslate">;</code> does not split arguments.
</div>
</dd></dl>

</section>
</section>
<section id="configuration-expressions">
<h3><a class="toc-backref" href="#id19" role="doc-backlink">Configuration Expressions</a><a class="headerlink" href="#configuration-expressions" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CONFIG">
$&lt;CONFIG&gt;<a class="headerlink" href="#genex:CONFIG" title="Permalink to this definition">¶</a></dt>
<dd>Configuration name. Use this instead of the deprecated <a class="reference internal" href="#genex:CONFIGURATION" title="CONFIGURATION"><code class="xref cmake cmake-genex docutils literal notranslate">CONFIGURATION</code></a>
generator expression.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;CONFIG:cfgs&gt;</dt>
<dd><code class="docutils literal notranslate">1</code> if config is any one of the entries in comma-separated list
<code class="docutils literal notranslate">cfgs</code>, else <code class="docutils literal notranslate">0</code>. This is a case-insensitive comparison. The mapping in
<a class="reference internal" href="../prop_tgt/MAP_IMPORTED_CONFIG_CONFIG.html#prop_tgt:MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;" title="MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">MAP_IMPORTED_CONFIG_&lt;CONFIG&gt;</code></a> is also considered by this
expression when it is evaluated on a property of an <a class="reference internal" href="../prop_tgt/IMPORTED.html#prop_tgt:IMPORTED" title="IMPORTED"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED</code></a>
target.
<div class="versionchanged">
Changed in version 3.19: Multiple configurations can be specified for <code class="docutils literal notranslate">cfgs</code>.
CMake 3.18 and earlier only accepted a single configuration.
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OUTPUT_CONFIG">
$&lt;OUTPUT_CONFIG:...&gt;<a class="headerlink" href="#genex:OUTPUT_CONFIG" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.20.
</div>
Only valid in <a class="reference internal" href="../command/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> and <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>
as the outer-most generator expression in an argument.
With the <a class="reference internal" href="../generator/Ninja%20Multi-Config.html#generator:Ninja Multi-Config" title="Ninja Multi-Config"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja Multi-Config</code></a> generator, generator expressions
in <code class="docutils literal notranslate">...</code> are evaluated using the custom command's &quot;output config&quot;.
With other generators, the content of <code class="docutils literal notranslate">...</code> is evaluated normally.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:COMMAND_CONFIG">
$&lt;COMMAND_CONFIG:...&gt;<a class="headerlink" href="#genex:COMMAND_CONFIG" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.20.
</div>
Only valid in <a class="reference internal" href="../command/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> and <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>
as the outer-most generator expression in an argument.
With the <a class="reference internal" href="../generator/Ninja%20Multi-Config.html#generator:Ninja Multi-Config" title="Ninja Multi-Config"><code class="xref cmake cmake-generator docutils literal notranslate">Ninja Multi-Config</code></a> generator, generator expressions
in <code class="docutils literal notranslate">...</code> are evaluated using the custom command's &quot;command config&quot;.
With other generators, the content of <code class="docutils literal notranslate">...</code> is evaluated normally.
</dd></dl>

</section>
<section id="toolchain-and-language-expressions">
<h3><a class="toc-backref" href="#id20" role="doc-backlink">Toolchain And Language Expressions</a><a class="headerlink" href="#toolchain-and-language-expressions" title="Permalink to this heading">¶</a></h3>
<section id="platform">
<h4><a class="toc-backref" href="#id21" role="doc-backlink">Platform</a><a class="headerlink" href="#platform" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:PLATFORM_ID">
$&lt;PLATFORM_ID&gt;<a class="headerlink" href="#genex:PLATFORM_ID" title="Permalink to this definition">¶</a></dt>
<dd>The current system's CMake platform id.
See also the <a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;PLATFORM_ID:platform_ids&gt;</dt>
<dd><code class="docutils literal notranslate">1</code> if CMake's platform id matches any one of the entries in
comma-separated list <code class="docutils literal notranslate">platform_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
See also the <a class="reference internal" href="../variable/CMAKE_SYSTEM_NAME.html#variable:CMAKE_SYSTEM_NAME" title="CMAKE_SYSTEM_NAME"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_SYSTEM_NAME</code></a> variable.
</dd></dl>

</section>
<section id="compiler-version">
<h4><a class="toc-backref" href="#id22" role="doc-backlink">Compiler Version</a><a class="headerlink" href="#compiler-version" title="Permalink to this heading">¶</a></h4>
See also the <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_VERSION.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_VERSION" title="CMAKE_&lt;LANG&gt;_COMPILER_VERSION"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_VERSION</code></a> variable, which is
closely related to the expressions in this sub-section.
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:C_COMPILER_VERSION">
$&lt;C_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:C_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd>The version of the C compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;C_COMPILER_VERSION:version&gt;</dt>
<dd><code class="docutils literal notranslate">1</code> if the version of the C compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CXX_COMPILER_VERSION">
$&lt;CXX_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:CXX_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd>The version of the CXX compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;CXX_COMPILER_VERSION:version&gt;</dt>
<dd><code class="docutils literal notranslate">1</code> if the version of the CXX compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CUDA_COMPILER_VERSION">
$&lt;CUDA_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:CUDA_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
The version of the CUDA compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;CUDA_COMPILER_VERSION:version&gt;</dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
<code class="docutils literal notranslate">1</code> if the version of the CXX compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OBJC_COMPILER_VERSION">
$&lt;OBJC_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:OBJC_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
The version of the OBJC compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;OBJC_COMPILER_VERSION:version&gt;</dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
<code class="docutils literal notranslate">1</code> if the version of the OBJC compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OBJCXX_COMPILER_VERSION">
$&lt;OBJCXX_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:OBJCXX_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
The version of the OBJCXX compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;OBJCXX_COMPILER_VERSION:version&gt;</dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
<code class="docutils literal notranslate">1</code> if the version of the OBJCXX compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:Fortran_COMPILER_VERSION">
$&lt;Fortran_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:Fortran_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd>The version of the Fortran compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;Fortran_COMPILER_VERSION:version&gt;</dt>
<dd><code class="docutils literal notranslate">1</code> if the version of the Fortran compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:HIP_COMPILER_VERSION">
$&lt;HIP_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:HIP_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.21.
</div>
The version of the HIP compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;HIP_COMPILER_VERSION:version&gt;</dt>
<dd><div class="versionadded">
New in version 3.21.
</div>
<code class="docutils literal notranslate">1</code> if the version of the HIP compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:ISPC_COMPILER_VERSION">
$&lt;ISPC_COMPILER_VERSION&gt;<a class="headerlink" href="#genex:ISPC_COMPILER_VERSION" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.19.
</div>
The version of the ISPC compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;ISPC_COMPILER_VERSION:version&gt;</dt>
<dd><div class="versionadded">
New in version 3.19.
</div>
<code class="docutils literal notranslate">1</code> if the version of the ISPC compiler matches <code class="docutils literal notranslate">version</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

</section>
<section id="compiler-language-and-id">
<h4><a class="toc-backref" href="#id23" role="doc-backlink">Compiler Language And ID</a><a class="headerlink" href="#compiler-language-and-id" title="Permalink to this heading">¶</a></h4>
See also the <a class="reference internal" href="../variable/CMAKE_LANG_COMPILER_ID.html#variable:CMAKE_&lt;LANG&gt;_COMPILER_ID" title="CMAKE_&lt;LANG&gt;_COMPILER_ID"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_COMPILER_ID</code></a> variable, which is closely
related to most of the expressions in this sub-section.
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:C_COMPILER_ID">
$&lt;C_COMPILER_ID&gt;<a class="headerlink" href="#genex:C_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd>CMake's compiler id of the C compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;C_COMPILER_ID:compiler_ids&gt;</dt>
<dd>where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the C compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CXX_COMPILER_ID">
$&lt;CXX_COMPILER_ID&gt;<a class="headerlink" href="#genex:CXX_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd>CMake's compiler id of the CXX compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;CXX_COMPILER_ID:compiler_ids&gt;</dt>
<dd>where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the CXX compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CUDA_COMPILER_ID">
$&lt;CUDA_COMPILER_ID&gt;<a class="headerlink" href="#genex:CUDA_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
CMake's compiler id of the CUDA compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;CUDA_COMPILER_ID:compiler_ids&gt;</dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the CUDA compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OBJC_COMPILER_ID">
$&lt;OBJC_COMPILER_ID&gt;<a class="headerlink" href="#genex:OBJC_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
CMake's compiler id of the OBJC compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;OBJC_COMPILER_ID:compiler_ids&gt;</dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the Objective-C compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:OBJCXX_COMPILER_ID">
$&lt;OBJCXX_COMPILER_ID&gt;<a class="headerlink" href="#genex:OBJCXX_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
CMake's compiler id of the OBJCXX compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;OBJCXX_COMPILER_ID:compiler_ids&gt;</dt>
<dd><div class="versionadded">
New in version 3.16.
</div>
where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the Objective-C++ compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:Fortran_COMPILER_ID">
$&lt;Fortran_COMPILER_ID&gt;<a class="headerlink" href="#genex:Fortran_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd>CMake's compiler id of the Fortran compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;Fortran_COMPILER_ID:compiler_ids&gt;</dt>
<dd>where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the Fortran compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:HIP_COMPILER_ID">
$&lt;HIP_COMPILER_ID&gt;<a class="headerlink" href="#genex:HIP_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.21.
</div>
CMake's compiler id of the HIP compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;HIP_COMPILER_ID:compiler_ids&gt;</dt>
<dd><div class="versionadded">
New in version 3.21.
</div>
where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the HIP compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:ISPC_COMPILER_ID">
$&lt;ISPC_COMPILER_ID&gt;<a class="headerlink" href="#genex:ISPC_COMPILER_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.19.
</div>
CMake's compiler id of the ISPC compiler used.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;ISPC_COMPILER_ID:compiler_ids&gt;</dt>
<dd><div class="versionadded">
New in version 3.19.
</div>
where <code class="docutils literal notranslate">compiler_ids</code> is a comma-separated list.
<code class="docutils literal notranslate">1</code> if CMake's compiler id of the ISPC compiler matches any one
of the entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:COMPILE_LANGUAGE">
$&lt;COMPILE_LANGUAGE&gt;<a class="headerlink" href="#genex:COMPILE_LANGUAGE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.3.
</div>
The compile language of source files when evaluating compile options.
See <a class="reference internal" href="#boolean-compile-language-generator-expression">the related boolean expression</a>
<code class="docutils literal notranslate">$&lt;COMPILE_LANGUAGE:language&gt;</code>
for notes about the portability of this generator expression.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;COMPILE_LANGUAGE:languages&gt;</dt>
<dd><div class="versionadded">
New in version 3.3.
</div>
<div class="versionchanged">
Changed in version 3.15: Multiple languages can be specified for <code class="docutils literal notranslate">languages</code>.
CMake 3.14 and earlier only accepted a single language.
</div>
<code class="docutils literal notranslate">1</code> when the language used for compilation unit matches any of the
comma-separated entries in <code class="docutils literal notranslate">languages</code>, otherwise <code class="docutils literal notranslate">0</code>. This expression
may be used to specify compile options, compile definitions, and include
directories for source files of a particular language in a target. For
example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_executable(myapp main.cpp foo.c bar.cpp zot.cu)
target_compile_options(myapp
 PRIVATE $&lt;$&lt;COMPILE_LANGUAGE:CXX&gt;:-fno-exceptions&gt;
)
target_compile_definitions(myapp
 PRIVATE $&lt;$&lt;COMPILE_LANGUAGE:CXX&gt;:COMPILING_CXX&gt;
 $&lt;$&lt;COMPILE_LANGUAGE:CUDA&gt;:COMPILING_CUDA&gt;
)
target_include_directories(myapp
 PRIVATE $&lt;$&lt;COMPILE_LANGUAGE:CXX,CUDA&gt;:/opt/foo/headers&gt;
)
</pre></div>
</div>
This specifies the use of the <code class="docutils literal notranslate">-fno-exceptions</code> compile option,
<code class="docutils literal notranslate">COMPILING_CXX</code> compile definition, and <code class="docutils literal notranslate">cxx_headers</code> include
directory for C++ only (compiler id checks elided). It also specifies
a <code class="docutils literal notranslate">COMPILING_CUDA</code> compile definition for CUDA.
Note that with <a class="reference internal" href="cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a> and <a class="reference internal" href="../generator/Xcode.html#generator:Xcode" title="Xcode"><code class="xref cmake cmake-generator docutils literal notranslate">Xcode</code></a> there
is no way to represent target-wide compile definitions or include directories
separately for <code class="docutils literal notranslate">C</code> and <code class="docutils literal notranslate">CXX</code> languages.
Also, with <a class="reference internal" href="cmake-generators.7.html#visual-studio-generators">Visual Studio Generators</a> there is no way to represent
target-wide flags separately for <code class="docutils literal notranslate">C</code> and <code class="docutils literal notranslate">CXX</code> languages. Under these
generators, expressions for both C and C++ sources will be evaluated
using <code class="docutils literal notranslate">CXX</code> if there are any C++ sources and otherwise using <code class="docutils literal notranslate">C</code>.
A workaround is to create separate libraries for each source file language
instead:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(myapp_c foo.c)
add_library(myapp_cxx bar.cpp)
target_compile_options(myapp_cxx PUBLIC -fno-exceptions)
add_executable(myapp main.cpp)
target_link_libraries(myapp myapp_c myapp_cxx)
</pre></div>
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:COMPILE_LANG_AND_ID">
$&lt;COMPILE_LANG_AND_ID:language,compiler_ids&gt;<a class="headerlink" href="#genex:COMPILE_LANG_AND_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
<code class="docutils literal notranslate">1</code> when the language used for compilation unit matches <code class="docutils literal notranslate">language</code> and
CMake's compiler id of the <code class="docutils literal notranslate">language</code> compiler matches any one of the
comma-separated entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>. This expression
is a short form for the combination of <code class="docutils literal notranslate">$&lt;COMPILE_LANGUAGE:language&gt;</code> and
<code class="docutils literal notranslate">$&lt;LANG_COMPILER_ID:compiler_ids&gt;</code>. This expression may be used to specify
compile options, compile definitions, and include directories for source
files of a particular language and compiler combination in a target.
For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_executable(myapp main.cpp foo.c bar.cpp zot.cu)
target_compile_definitions(myapp
 PRIVATE $&lt;$&lt;COMPILE_LANG_AND_ID:CXX,AppleClang,Clang&gt;:COMPILING_CXX_WITH_CLANG&gt;
 $&lt;$&lt;COMPILE_LANG_AND_ID:CXX,Intel&gt;:COMPILING_CXX_WITH_INTEL&gt;
 $&lt;$&lt;COMPILE_LANG_AND_ID:C,Clang&gt;:COMPILING_C_WITH_CLANG&gt;
)
</pre></div>
</div>
This specifies the use of different compile definitions based on both
the compiler id and compilation language. This example will have a
<code class="docutils literal notranslate">COMPILING_CXX_WITH_CLANG</code> compile definition when Clang is the CXX
compiler, and <code class="docutils literal notranslate">COMPILING_CXX_WITH_INTEL</code> when Intel is the CXX compiler.
Likewise, when the C compiler is Clang, it will only see the
<code class="docutils literal notranslate">COMPILING_C_WITH_CLANG</code> definition.
Without the <code class="docutils literal notranslate">COMPILE_LANG_AND_ID</code> generator expression, the same logic
would be expressed as:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_compile_definitions(myapp
 PRIVATE $&lt;$&lt;AND:$&lt;COMPILE_LANGUAGE:CXX&gt;,$&lt;CXX_COMPILER_ID:AppleClang,Clang&gt;&gt;:COMPILING_CXX_WITH_CLANG&gt;
 $&lt;$&lt;AND:$&lt;COMPILE_LANGUAGE:CXX&gt;,$&lt;CXX_COMPILER_ID:Intel&gt;&gt;:COMPILING_CXX_WITH_INTEL&gt;
 $&lt;$&lt;AND:$&lt;COMPILE_LANGUAGE:C&gt;,$&lt;C_COMPILER_ID:Clang&gt;&gt;:COMPILING_C_WITH_CLANG&gt;
)
</pre></div>
</div>
</dd></dl>

</section>
<section id="compile-features">
<h4><a class="toc-backref" href="#id24" role="doc-backlink">Compile Features</a><a class="headerlink" href="#compile-features" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:COMPILE_FEATURES">
$&lt;COMPILE_FEATURES:features&gt;<a class="headerlink" href="#genex:COMPILE_FEATURES" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
where <code class="docutils literal notranslate">features</code> is a comma-separated list.
Evaluates to <code class="docutils literal notranslate">1</code> if all of the <code class="docutils literal notranslate">features</code> are available for the 'head'
target, and <code class="docutils literal notranslate">0</code> otherwise. If this expression is used while evaluating
the link implementation of a target and if any dependency transitively
increases the required <a class="reference internal" href="../prop_tgt/C_STANDARD.html#prop_tgt:C_STANDARD" title="C_STANDARD"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">C_STANDARD</code></a> or <a class="reference internal" href="../prop_tgt/CXX_STANDARD.html#prop_tgt:CXX_STANDARD" title="CXX_STANDARD"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CXX_STANDARD</code></a>
for the 'head' target, an error is reported. See the
<a class="reference internal" href="cmake-compile-features.7.html#manual:cmake-compile-features(7)" title="cmake-compile-features(7)"><code class="xref cmake cmake-manual docutils literal notranslate">cmake-compile-features(7)</code></a> manual for information on
compile features and a list of supported compilers.
</dd></dl>

</section>
<section id="linker-language-and-id">
<h4><a class="toc-backref" href="#id25" role="doc-backlink">Linker Language And ID</a><a class="headerlink" href="#linker-language-and-id" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LINK_LANGUAGE">
$&lt;LINK_LANGUAGE&gt;<a class="headerlink" href="#genex:LINK_LANGUAGE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.18.
</div>
The link language of the target when evaluating link options.
See <a class="reference internal" href="#boolean-link-language-generator-expression">the related boolean expression</a> <code class="docutils literal notranslate">$&lt;LINK_LANGUAGE:languages&gt;</code>
for notes about the portability of this generator expression.
<div class="admonition note">
Note
This generator expression is not supported by the link libraries
properties to avoid side-effects due to the double evaluation of
these properties.
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;LINK_LANGUAGE:languages&gt;</dt>
<dd><div class="versionadded">
New in version 3.18.
</div>
<code class="docutils literal notranslate">1</code> when the language used for link step matches any of the comma-separated
entries in <code class="docutils literal notranslate">languages</code>, otherwise <code class="docutils literal notranslate">0</code>. This expression may be used to
specify link libraries, link options, link directories and link dependencies
of a particular language in a target. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(api_C ...)
add_library(api_CXX ...)
add_library(api INTERFACE)
target_link_options(api INTERFACE $&lt;$&lt;LINK_LANGUAGE:C&gt;:-opt_c&gt;
 $&lt;$&lt;LINK_LANGUAGE:CXX&gt;:-opt_cxx&gt;)
target_link_libraries(api INTERFACE $&lt;$&lt;LINK_LANGUAGE:C&gt;:api_C&gt;
 $&lt;$&lt;LINK_LANGUAGE:CXX&gt;:api_CXX&gt;)

add_executable(myapp1 main.c)
target_link_options(myapp1 PRIVATE api)

add_executable(myapp2 main.cpp)
target_link_options(myapp2 PRIVATE api)
</pre></div>
</div>
This specifies to use the <code class="docutils literal notranslate">api</code> target for linking targets <code class="docutils literal notranslate">myapp1</code> and
<code class="docutils literal notranslate">myapp2</code>. In practice, <code class="docutils literal notranslate">myapp1</code> will link with target <code class="docutils literal notranslate">api_C</code> and
option <code class="docutils literal notranslate">-opt_c</code> because it will use <code class="docutils literal notranslate">C</code> as link language. And <code class="docutils literal notranslate">myapp2</code>
will link with <code class="docutils literal notranslate">api_CXX</code> and option <code class="docutils literal notranslate">-opt_cxx</code> because <code class="docutils literal notranslate">CXX</code> will be
the link language.
<div class="admonition note" id="constraints-link-language-generator-expression">
Note
To determine the link language of a target, it is required to collect,
transitively, all the targets which will be linked to it. So, for link
libraries properties, a double evaluation will be done. During the first
evaluation, <code class="docutils literal notranslate">$&lt;LINK_LANGUAGE:..&gt;</code> expressions will always return <code class="docutils literal notranslate">0</code>.
The link language computed after this first pass will be used to do the
second pass. To avoid inconsistency, it is required that the second pass
do not change the link language. Moreover, to avoid unexpected
side-effects, it is required to specify complete entities as part of the
<code class="docutils literal notranslate">$&lt;LINK_LANGUAGE:..&gt;</code> expression. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib STATIC file.cxx)
add_library(libother STATIC file.c)

# bad usage
add_executable(myapp1 main.c)
target_link_libraries(myapp1 PRIVATE lib$&lt;$&lt;LINK_LANGUAGE:C&gt;:other&gt;)

# correct usage
add_executable(myapp2 main.c)
target_link_libraries(myapp2 PRIVATE $&lt;$&lt;LINK_LANGUAGE:C&gt;:libother&gt;)
</pre></div>
</div>
In this example, for <code class="docutils literal notranslate">myapp1</code>, the first pass will, unexpectedly,
determine that the link language is <code class="docutils literal notranslate">CXX</code> because the evaluation of the
generator expression will be an empty string so <code class="docutils literal notranslate">myapp1</code> will depends on
target <code class="docutils literal notranslate">lib</code> which is <code class="docutils literal notranslate">C++</code>. On the contrary, for <code class="docutils literal notranslate">myapp2</code>, the first
evaluation will give <code class="docutils literal notranslate">C</code> as link language, so the second pass will
correctly add target <code class="docutils literal notranslate">libother</code> as link dependency.
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LINK_LANG_AND_ID">
$&lt;LINK_LANG_AND_ID:language,compiler_ids&gt;<a class="headerlink" href="#genex:LINK_LANG_AND_ID" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.18.
</div>
<code class="docutils literal notranslate">1</code> when the language used for link step matches <code class="docutils literal notranslate">language</code> and the
CMake's compiler id of the language linker matches any one of the comma-separated
entries in <code class="docutils literal notranslate">compiler_ids</code>, otherwise <code class="docutils literal notranslate">0</code>. This expression is a short form
for the combination of <code class="docutils literal notranslate">$&lt;LINK_LANGUAGE:language&gt;</code> and
<code class="docutils literal notranslate">$&lt;LANG_COMPILER_ID:compiler_ids&gt;</code>. This expression may be used to specify
link libraries, link options, link directories and link dependencies of a
particular language and linker combination in a target. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(libC_Clang ...)
add_library(libCXX_Clang ...)
add_library(libC_Intel ...)
add_library(libCXX_Intel ...)

add_executable(myapp main.c)
if (CXX_CONFIG)
 target_sources(myapp PRIVATE file.cxx)
endif()
target_link_libraries(myapp
 PRIVATE $&lt;$&lt;LINK_LANG_AND_ID:CXX,Clang,AppleClang&gt;:libCXX_Clang&gt;
 $&lt;$&lt;LINK_LANG_AND_ID:C,Clang,AppleClang&gt;:libC_Clang&gt;
 $&lt;$&lt;LINK_LANG_AND_ID:CXX,Intel&gt;:libCXX_Intel&gt;
 $&lt;$&lt;LINK_LANG_AND_ID:C,Intel&gt;:libC_Intel&gt;)
</pre></div>
</div>
This specifies the use of different link libraries based on both the
compiler id and link language. This example will have target <code class="docutils literal notranslate">libCXX_Clang</code>
as link dependency when <code class="docutils literal notranslate">Clang</code> or <code class="docutils literal notranslate">AppleClang</code> is the <code class="docutils literal notranslate">CXX</code>
linker, and <code class="docutils literal notranslate">libCXX_Intel</code> when <code class="docutils literal notranslate">Intel</code> is the <code class="docutils literal notranslate">CXX</code> linker.
Likewise when the <code class="docutils literal notranslate">C</code> linker is <code class="docutils literal notranslate">Clang</code> or <code class="docutils literal notranslate">AppleClang</code>, target
<code class="docutils literal notranslate">libC_Clang</code> will be added as link dependency and <code class="docutils literal notranslate">libC_Intel</code> when
<code class="docutils literal notranslate">Intel</code> is the <code class="docutils literal notranslate">C</code> linker.
See <a class="reference internal" href="#constraints-link-language-generator-expression">the note related to</a>
<code class="docutils literal notranslate">$&lt;LINK_LANGUAGE:language&gt;</code> for constraints about the usage of this
generator expression.
</dd></dl>

</section>
<section id="link-features">
<h4><a class="toc-backref" href="#id26" role="doc-backlink">Link Features</a><a class="headerlink" href="#link-features" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LINK_LIBRARY">
$&lt;LINK_LIBRARY:feature,library-list&gt;<a class="headerlink" href="#genex:LINK_LIBRARY" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Specify a set of libraries to link to a target, along with a <code class="docutils literal notranslate">feature</code>
which provides details about how they should be linked. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1 STATIC ...)
add_library(lib2 ...)
target_link_libraries(lib2 PRIVATE &quot;$&lt;LINK_LIBRARY:WHOLE_ARCHIVE,lib1&gt;&quot;)
</pre></div>
</div>
This specifies that <code class="docutils literal notranslate">lib2</code> should link to <code class="docutils literal notranslate">lib1</code> and use the
<code class="docutils literal notranslate">WHOLE_ARCHIVE</code> feature when doing so.
Feature names are case-sensitive and may only contain letters, numbers and
underscores. Feature names defined in all uppercase are reserved for CMake's
own built-in features. The pre-defined built-in library features are:
<dl>
<dt><code class="docutils literal notranslate">DEFAULT</code></dt><dd>This feature corresponds to standard linking, essentially equivalent to
using no feature at all. It is typically only used with the
<a class="reference internal" href="../prop_tgt/LINK_LIBRARY_OVERRIDE.html#prop_tgt:LINK_LIBRARY_OVERRIDE" title="LINK_LIBRARY_OVERRIDE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARY_OVERRIDE</code></a> and
<a class="reference internal" href="../prop_tgt/LINK_LIBRARY_OVERRIDE_LIBRARY.html#prop_tgt:LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;" title="LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;</code></a> target properties.
</dd>
<dt><code class="docutils literal notranslate">WHOLE_ARCHIVE</code></dt><dd>Force inclusion of all members of a static library. This feature is only
supported for the following platforms, with limitations as noted:
<ul class="simple">
<li>Linux.</li>
<li>All BSD variants.</li>
<li>SunOS.</li>
<li>All Apple variants. The library must be specified as a CMake target name,
a library file name (such as <code class="docutils literal notranslate">libfoo.a</code>), or a library file path (such as
<code class="docutils literal notranslate">/path/to/libfoo.a</code>). Due to a limitation of the Apple linker, it
cannot be specified as a plain library name like <code class="docutils literal notranslate">foo</code>, where <code class="docutils literal notranslate">foo</code>
is not a CMake target.</li>
<li>Windows. When using a MSVC or MSVC-like toolchain, the MSVC version must
be greater than 1900.</li>
<li>Cygwin.</li>
<li>MSYS.</li>
</ul>
</dd>
<dt><code class="docutils literal notranslate">FRAMEWORK</code></dt><dd>This option tells the linker to search for the specified framework using
the <code class="docutils literal notranslate">-framework</code> linker option. It can only be used on Apple platforms,
and only with a linker that understands the option used (i.e. the linker
provided with Xcode, or one compatible with it).
The framework can be specified as a CMake framework target, a bare framework
name, or a file path. If a target is given, that target must have the
<a class="reference internal" href="../prop_tgt/FRAMEWORK.html#prop_tgt:FRAMEWORK" title="FRAMEWORK"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">FRAMEWORK</code></a> target property set to true. For a file path, if it
contains a directory part, that directory will be added as a framework
search path.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib SHARED ...)
target_link_libraries(lib PRIVATE &quot;$&lt;LINK_LIBRARY:FRAMEWORK,/path/to/my_framework&gt;&quot;)

# The constructed linker command line will contain:
# -F/path/to -framework my_framework
</pre></div>
</div>
File paths must conform to one of the following patterns (<code class="docutils literal notranslate">*</code> is a
wildcard, and optional parts are shown as <code class="docutils literal notranslate">[...]</code>):
<blockquote>
<div><ul class="simple">
<li><code class="docutils literal notranslate">[/path/to/]FwName[.framework]</code></li>
<li><code class="docutils literal notranslate">[/path/to/]FwName.framework/FwName[suffix]</code></li>
<li><code class="docutils literal notranslate">[/path/to/]FwName.framework/Versions/*/FwName[suffix]</code></li>
</ul>
</div></blockquote>
Note that CMake recognizes and automatically handles framework targets,
even without using the <a class="reference internal" href="#genex:LINK_LIBRARY" title="LINK_LIBRARY"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;LINK_LIBRARY:FRAMEWORK,...&gt;</code></a> expression.
The generator expression can still be used with a CMake target if the
project wants to be explicit about it, but it is not required to do so.
The linker command line may have some differences between using the
generator expression or not, but the final result should be the same.
On the other hand, if a file path is given, CMake will recognize some paths
automatically, but not all cases. The project may want to use
<a class="reference internal" href="#genex:LINK_LIBRARY" title="LINK_LIBRARY"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;LINK_LIBRARY:FRAMEWORK,...&gt;</code></a> for file paths so that the expected
behavior is clear.
<div class="versionadded">
New in version 3.25: The <a class="reference internal" href="../prop_tgt/FRAMEWORK_MULTI_CONFIG_POSTFIX_CONFIG.html#prop_tgt:FRAMEWORK_MULTI_CONFIG_POSTFIX_&lt;CONFIG&gt;" title="FRAMEWORK_MULTI_CONFIG_POSTFIX_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">FRAMEWORK_MULTI_CONFIG_POSTFIX_&lt;CONFIG&gt;</code></a> target property as
well as the <code class="docutils literal notranslate">suffix</code> of the framework library name are now supported by
the <code class="docutils literal notranslate">FRAMEWORK</code> features.
</div>
</dd>
<dt><code class="docutils literal notranslate">NEEDED_FRAMEWORK</code></dt><dd>This is similar to the <code class="docutils literal notranslate">FRAMEWORK</code> feature, except it forces the linker
to link with the framework even if no symbols are used from it. It uses
the <code class="docutils literal notranslate">-needed_framework</code> option and has the same linker constraints as
<code class="docutils literal notranslate">FRAMEWORK</code>.
</dd>
<dt><code class="docutils literal notranslate">REEXPORT_FRAMEWORK</code></dt><dd>This is similar to the <code class="docutils literal notranslate">FRAMEWORK</code> feature, except it tells the linker
that the framework should be available to clients linking to the library
being created. It uses the <code class="docutils literal notranslate">-reexport_framework</code> option and has the
same linker constraints as <code class="docutils literal notranslate">FRAMEWORK</code>.
</dd>
<dt><code class="docutils literal notranslate">WEAK_FRAMEWORK</code></dt><dd>This is similar to the <code class="docutils literal notranslate">FRAMEWORK</code> feature, except it forces the linker
to mark the framework and all references to it as weak imports. It uses
the <code class="docutils literal notranslate">-weak_framework</code> option and has the same linker constraints as
<code class="docutils literal notranslate">FRAMEWORK</code>.
</dd>
<dt><code class="docutils literal notranslate">NEEDED_LIBRARY</code></dt><dd>This is similar to the <code class="docutils literal notranslate">NEEDED_FRAMEWORK</code> feature, except it is for use
with non-framework targets or libraries (Apple platforms only).
It uses the <code class="docutils literal notranslate">-needed_library</code> or <code class="docutils literal notranslate">-needed-l</code> option as appropriate,
and has the same linker constraints as <code class="docutils literal notranslate">NEEDED_FRAMEWORK</code>.
</dd>
<dt><code class="docutils literal notranslate">REEXPORT_LIBRARY</code></dt><dd>This is similar to the <code class="docutils literal notranslate">REEXPORT_FRAMEWORK</code> feature, except it is for use
with non-framework targets or libraries (Apple platforms only).
It uses the <code class="docutils literal notranslate">-reexport_library</code> or <code class="docutils literal notranslate">-reexport-l</code> option as appropriate,
and has the same linker constraints as <code class="docutils literal notranslate">REEXPORT_FRAMEWORK</code>.
</dd>
<dt><code class="docutils literal notranslate">WEAK_LIBRARY</code></dt><dd>This is similar to the <code class="docutils literal notranslate">WEAK_FRAMEWORK</code> feature, except it is for use
with non-framework targets or libraries (Apple platforms only).
It uses the <code class="docutils literal notranslate">-weak_library</code> or <code class="docutils literal notranslate">-weak-l</code> option as appropriate,
and has the same linker constraints as <code class="docutils literal notranslate">WEAK_FRAMEWORK</code>.
</dd>
</dl>
Built-in and custom library features are defined in terms of the following
variables:
<ul class="simple">
<li><a class="reference internal" href="../variable/CMAKE_LANG_LINK_LIBRARY_USING_FEATURE_SUPPORTED.html#variable:CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LANG_LINK_LIBRARY_USING_FEATURE.html#variable:CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;" title="CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LINK_LIBRARY_USING_FEATURE_SUPPORTED.html#variable:CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LINK_LIBRARY_USING_FEATURE.html#variable:CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;" title="CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;</code></a></li>
</ul>
The value used for each of these variables is the value as set at the end of
the directory scope in which the target was created. The usage is as follows:
<ol class="arabic simple">
<li>If the language-specific
<a class="reference internal" href="../variable/CMAKE_LANG_LINK_LIBRARY_USING_FEATURE_SUPPORTED.html#variable:CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED</code></a> variable
is true, the <code class="docutils literal notranslate">feature</code> must be defined by the corresponding
<a class="reference internal" href="../variable/CMAKE_LANG_LINK_LIBRARY_USING_FEATURE.html#variable:CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;" title="CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_LIBRARY_USING_&lt;FEATURE&gt;</code></a> variable.</li>
<li>If no language-specific <code class="docutils literal notranslate">feature</code> is supported, then the
<a class="reference internal" href="../variable/CMAKE_LINK_LIBRARY_USING_FEATURE_SUPPORTED.html#variable:CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;_SUPPORTED</code></a> variable must be
true and the <code class="docutils literal notranslate">feature</code> must be defined by the corresponding
<a class="reference internal" href="../variable/CMAKE_LINK_LIBRARY_USING_FEATURE.html#variable:CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;" title="CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_LIBRARY_USING_&lt;FEATURE&gt;</code></a> variable.</li>
</ol>
The following limitations should be noted:
<ul>
<li>The <code class="docutils literal notranslate">library-list</code> can specify CMake targets or libraries.
Any CMake target of type <a class="reference internal" href="cmake-buildsystem.7.html#object-libraries">OBJECT</a>
or <a class="reference internal" href="cmake-buildsystem.7.html#interface-libraries">INTERFACE</a> will ignore the feature aspect
of the expression and instead be linked in the standard way.</li>
<li>The <code class="docutils literal notranslate">$&lt;LINK_LIBRARY:...&gt;</code> generator expression can only be used to
specify link libraries. In practice, this means it can appear in the
<a class="reference internal" href="../prop_tgt/LINK_LIBRARIES.html#prop_tgt:LINK_LIBRARIES" title="LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARIES</code></a>, <a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a>, and
<a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES_DIRECT.html#prop_tgt:INTERFACE_LINK_LIBRARIES_DIRECT" title="INTERFACE_LINK_LIBRARIES_DIRECT"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES_DIRECT</code></a> target properties, and be
specified in <a class="reference internal" href="../command/target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a> and <a class="reference internal" href="../command/link_libraries.html#command:link_libraries" title="link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">link_libraries()</code></a>
commands.</li>
<li>If a <code class="docutils literal notranslate">$&lt;LINK_LIBRARY:...&gt;</code> generator expression appears in the
<a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a> property of a target, it will be
included in the imported target generated by a <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(EXPORT)</code></a>
command. It is the responsibility of the environment consuming this
import to define the link feature used by this expression.</li>
<li>Each target or library involved in the link step must have at most only
one kind of library feature. The absence of a feature is also incompatible
with all other features. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)

# lib1 will be associated with feature1
target_link_libraries(lib2 PUBLIC &quot;$&lt;LINK_LIBRARY:feature1,lib1&gt;&quot;)

# lib1 is being linked with no feature here. This conflicts with the
# use of feature1 in the line above and would result in an error.
target_link_libraries(lib3 PRIVATE lib1 lib2)
</pre></div>
</div>
Where it isn't possible to use the same feature throughout a build for a
given target or library, the <a class="reference internal" href="../prop_tgt/LINK_LIBRARY_OVERRIDE.html#prop_tgt:LINK_LIBRARY_OVERRIDE" title="LINK_LIBRARY_OVERRIDE"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARY_OVERRIDE</code></a> and
<a class="reference internal" href="../prop_tgt/LINK_LIBRARY_OVERRIDE_LIBRARY.html#prop_tgt:LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;" title="LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARY_OVERRIDE_&lt;LIBRARY&gt;</code></a> target properties can be
used to resolve such incompatibilities.
</li>
<li>The <code class="docutils literal notranslate">$&lt;LINK_LIBRARY:...&gt;</code> generator expression does not guarantee
that the list of specified targets and libraries will be kept grouped
together. To manage constructs like <code class="docutils literal notranslate">--start-group</code> and <code class="docutils literal notranslate">--end-group</code>,
as supported by the GNU <code class="docutils literal notranslate">ld</code> linker, use the <a class="reference internal" href="#genex:LINK_GROUP" title="LINK_GROUP"><code class="xref cmake cmake-genex docutils literal notranslate">LINK_GROUP</code></a>
generator expression instead.</li>
</ul>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LINK_GROUP">
$&lt;LINK_GROUP:feature,library-list&gt;<a class="headerlink" href="#genex:LINK_GROUP" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Specify a group of libraries to link to a target, along with a <code class="docutils literal notranslate">feature</code>
which defines how that group should be linked. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1 STATIC ...)
add_library(lib2 ...)
target_link_libraries(lib2 PRIVATE &quot;$&lt;LINK_GROUP:RESCAN,lib1,external&gt;&quot;)
</pre></div>
</div>
This specifies that <code class="docutils literal notranslate">lib2</code> should link to <code class="docutils literal notranslate">lib1</code> and <code class="docutils literal notranslate">external</code>, and
that both of those two libraries should be included on the linker command
line according to the definition of the <code class="docutils literal notranslate">RESCAN</code> feature.
Feature names are case-sensitive and may only contain letters, numbers and
underscores. Feature names defined in all uppercase are reserved for CMake's
own built-in features. Currently, there is only one pre-defined built-in
group feature:
<dl>
<dt><code class="docutils literal notranslate">RESCAN</code></dt><dd>Some linkers are single-pass only. For such linkers, circular references
between libraries typically result in unresolved symbols. This feature
instructs the linker to search the specified static libraries repeatedly
until no new undefined references are created.
Normally, a static library is searched only once in the order that it is
specified on the command line. If a symbol in that library is needed to
resolve an undefined symbol referred to by an object in a library that
appears later on the command line, the linker would not be able to resolve
that reference. By grouping the static libraries with the <code class="docutils literal notranslate">RESCAN</code>
feature, they will all be searched repeatedly until all possible references
are resolved. This will use linker options like <code class="docutils literal notranslate">--start-group</code> and
<code class="docutils literal notranslate">--end-group</code>, or on SunOS, <code class="docutils literal notranslate">-z rescan-start</code> and <code class="docutils literal notranslate">-z rescan-end</code>.
Using this feature has a significant performance cost. It is best to use it
only when there are unavoidable circular references between two or more
static libraries.
This feature is available when using toolchains that target Linux, BSD, and
SunOS. It can also be used when targeting Windows platforms if the GNU
toolchain is used.
</dd>
</dl>
Built-in and custom group features are defined in terms of the following
variables:
<ul class="simple">
<li><a class="reference internal" href="../variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE_SUPPORTED.html#variable:CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.html#variable:CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;" title="CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LINK_GROUP_USING_FEATURE_SUPPORTED.html#variable:CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED</code></a></li>
<li><a class="reference internal" href="../variable/CMAKE_LINK_GROUP_USING_FEATURE.html#variable:CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;" title="CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;</code></a></li>
</ul>
The value used for each of these variables is the value as set at the end of
the directory scope in which the target was created. The usage is as follows:
<ol class="arabic simple">
<li>If the language-specific
<a class="reference internal" href="../variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE_SUPPORTED.html#variable:CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED</code></a> variable
is true, the <code class="docutils literal notranslate">feature</code> must be defined by the corresponding
<a class="reference internal" href="../variable/CMAKE_LANG_LINK_GROUP_USING_FEATURE.html#variable:CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;" title="CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_&lt;LANG&gt;_LINK_GROUP_USING_&lt;FEATURE&gt;</code></a> variable.</li>
<li>If no language-specific <code class="docutils literal notranslate">feature</code> is supported, then the
<a class="reference internal" href="../variable/CMAKE_LINK_GROUP_USING_FEATURE_SUPPORTED.html#variable:CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED" title="CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;_SUPPORTED</code></a> variable must be
true and the <code class="docutils literal notranslate">feature</code> must be defined by the corresponding
<a class="reference internal" href="../variable/CMAKE_LINK_GROUP_USING_FEATURE.html#variable:CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;" title="CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_LINK_GROUP_USING_&lt;FEATURE&gt;</code></a> variable.</li>
</ol>
The <code class="docutils literal notranslate">LINK_GROUP</code> generator expression is compatible with the
<a class="reference internal" href="#genex:LINK_LIBRARY" title="LINK_LIBRARY"><code class="xref cmake cmake-genex docutils literal notranslate">LINK_LIBRARY</code></a> generator expression. The libraries involved in a
group can be specified using the <a class="reference internal" href="#genex:LINK_LIBRARY" title="LINK_LIBRARY"><code class="xref cmake cmake-genex docutils literal notranslate">LINK_LIBRARY</code></a> generator expression.
Each target or external library involved in the link step is allowed to be
part of multiple groups, but only if all the groups involved specify the
same <code class="docutils literal notranslate">feature</code>. Such groups will not be merged on the linker command line,
the individual groups will still be preserved. Mixing different group
features for the same target or library is forbidden.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)
add_library(lib4 ...)
add_library(lib5 ...)

target_link_libraries(lib3 PUBLIC &quot;$&lt;LINK_GROUP:feature1,lib1,lib2&gt;&quot;)
target_link_libraries(lib4 PRIVATE &quot;$&lt;LINK_GROUP:feature1,lib1,lib3&gt;&quot;)
# lib4 will be linked with the groups {lib1,lib2} and {lib1,lib3}.
# Both groups specify the same feature, so this is fine.

target_link_libraries(lib5 PRIVATE &quot;$&lt;LINK_GROUP:feature2,lib1,lib3&gt;&quot;)
# An error will be raised here because both lib1 and lib3 are part of two
# groups with different features.
</pre></div>
</div>
When a target or an external library is involved in the link step as part of
a group and also as not part of any group, any occurrence of the non-group
link item will be replaced by the groups it belongs to.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1 ...)
add_library(lib2 ...)
add_library(lib3 ...)
add_library(lib4 ...)

target_link_libraries(lib4 PRIVATE lib3 &quot;$&lt;LINK_GROUP:feature1,lib1,lib2&gt;&quot;)
# lib4 will only be linked with lib3 and the group {lib1,lib2}
</pre></div>
</div>
Because <code class="docutils literal notranslate">lib1</code> is part of the group defined for <code class="docutils literal notranslate">lib4</code>, that group then
gets applied back to the use of <code class="docutils literal notranslate">lib1</code> for <code class="docutils literal notranslate">lib3</code>. The end result will
be as though the linking relationship for <code class="docutils literal notranslate">lib3</code> had been specified as:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_link_libraries(lib3 PUBLIC &quot;$&lt;LINK_GROUP:feature1,lib1,lib2&gt;&quot;)
</pre></div>
</div>
Be aware that the precedence of the group over the non-group link item can
result in circular dependencies between groups. If this occurs, a fatal
error is raised because circular dependencies are not allowed for groups.
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(lib1A ...)
add_library(lib1B ...)
add_library(lib2A ...)
add_library(lib2B ...)
add_library(lib3 ...)

# Non-group linking relationships, these are non-circular so far
target_link_libraries(lib1A PUBLIC lib2A)
target_link_libraries(lib2B PUBLIC lib1B)

# The addition of these groups creates circular dependencies
target_link_libraries(lib3 PRIVATE
 &quot;$&lt;LINK_GROUP:feat,lib1A,lib1B&gt;&quot;
 &quot;$&lt;LINK_GROUP:feat,lib2A,lib2B&gt;&quot;
)
</pre></div>
</div>
Because of the groups defined for <code class="docutils literal notranslate">lib3</code>, the linking relationships for
<code class="docutils literal notranslate">lib1A</code> and <code class="docutils literal notranslate">lib2B</code> effectively get expanded to the equivalent of:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>target_link_libraries(lib1A PUBLIC &quot;$&lt;LINK_GROUP:feat,lib2A,lib2B&gt;&quot;)
target_link_libraries(lib2B PUBLIC &quot;$&lt;LINK_GROUP:feat,lib1A,lib1B&gt;&quot;)
</pre></div>
</div>
This creates a circular dependency between groups:
<code class="docutils literal notranslate">lib1A --&gt; lib2B --&gt; lib1A</code>.
The following limitations should also be noted:
<ul class="simple">
<li>The <code class="docutils literal notranslate">library-list</code> can specify CMake targets or libraries.
Any CMake target of type <a class="reference internal" href="cmake-buildsystem.7.html#object-libraries">OBJECT</a>
or <a class="reference internal" href="cmake-buildsystem.7.html#interface-libraries">INTERFACE</a> will ignore the feature aspect
of the expression and instead be linked in the standard way.</li>
<li>The <code class="docutils literal notranslate">$&lt;LINK_GROUP:...&gt;</code> generator expression can only be used to
specify link libraries. In practice, this means it can appear in the
<a class="reference internal" href="../prop_tgt/LINK_LIBRARIES.html#prop_tgt:LINK_LIBRARIES" title="LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARIES</code></a>, <a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a>,and
<a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES_DIRECT.html#prop_tgt:INTERFACE_LINK_LIBRARIES_DIRECT" title="INTERFACE_LINK_LIBRARIES_DIRECT"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES_DIRECT</code></a> target properties, and be
specified in <a class="reference internal" href="../command/target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a> and <a class="reference internal" href="../command/link_libraries.html#command:link_libraries" title="link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">link_libraries()</code></a>
commands.</li>
<li>If a <code class="docutils literal notranslate">$&lt;LINK_GROUP:...&gt;</code> generator expression appears in the
<a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a> property of a target, it will be
included in the imported target generated by a <a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(EXPORT)</code></a>
command. It is the responsibility of the environment consuming this
import to define the link feature used by this expression.</li>
</ul>
</dd></dl>

</section>
<section id="link-context">
<h4><a class="toc-backref" href="#id27" role="doc-backlink">Link Context</a><a class="headerlink" href="#link-context" title="Permalink to this heading">¶</a></h4>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:LINK_ONLY">
$&lt;LINK_ONLY:...&gt;<a class="headerlink" href="#genex:LINK_ONLY" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
Content of <code class="docutils literal notranslate">...</code>, except while collecting <a class="reference internal" href="cmake-buildsystem.7.html#target-usage-requirements">Transitive Usage Requirements</a>,
in which case it is the empty string. This is intended for use in an
<a class="reference internal" href="../prop_tgt/INTERFACE_LINK_LIBRARIES.html#prop_tgt:INTERFACE_LINK_LIBRARIES" title="INTERFACE_LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INTERFACE_LINK_LIBRARIES</code></a> target property, typically populated
via the <a class="reference internal" href="../command/target_link_libraries.html#command:target_link_libraries" title="target_link_libraries"><code class="xref cmake cmake-command docutils literal notranslate">target_link_libraries()</code></a> command, to specify private link
dependencies without other usage requirements.
<div class="versionadded">
New in version 3.24: <code class="docutils literal notranslate">LINK_ONLY</code> may also be used in a <a class="reference internal" href="../prop_tgt/LINK_LIBRARIES.html#prop_tgt:LINK_LIBRARIES" title="LINK_LIBRARIES"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LINK_LIBRARIES</code></a> target
property. See policy <a class="reference internal" href="../policy/CMP0131.html#policy:CMP0131" title="CMP0131"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0131</code></a>.
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:DEVICE_LINK">
$&lt;DEVICE_LINK:list&gt;<a class="headerlink" href="#genex:DEVICE_LINK" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.18.
</div>
Returns the list if it is the device link step, an empty list otherwise.
The device link step is controlled by <a class="reference internal" href="../prop_tgt/CUDA_SEPARABLE_COMPILATION.html#prop_tgt:CUDA_SEPARABLE_COMPILATION" title="CUDA_SEPARABLE_COMPILATION"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CUDA_SEPARABLE_COMPILATION</code></a>
and <a class="reference internal" href="../prop_tgt/CUDA_RESOLVE_DEVICE_SYMBOLS.html#prop_tgt:CUDA_RESOLVE_DEVICE_SYMBOLS" title="CUDA_RESOLVE_DEVICE_SYMBOLS"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">CUDA_RESOLVE_DEVICE_SYMBOLS</code></a> properties and
policy <a class="reference internal" href="../policy/CMP0105.html#policy:CMP0105" title="CMP0105"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0105</code></a>. This expression can only be used to specify link
options.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:HOST_LINK">
$&lt;HOST_LINK:list&gt;<a class="headerlink" href="#genex:HOST_LINK" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.18.
</div>
Returns the list if it is the normal link step, an empty list otherwise.
This expression is mainly useful when a device link step is also involved
(see <a class="reference internal" href="#genex:DEVICE_LINK" title="DEVICE_LINK"><code class="xref cmake cmake-genex docutils literal notranslate">$&lt;DEVICE_LINK:list&gt;</code></a> generator expression). This expression can
only be used to specify link options.
</dd></dl>

</section>
</section>
<section id="target-dependent-expressions">
<h3><a class="toc-backref" href="#id28" role="doc-backlink">Target-Dependent Expressions</a><a class="headerlink" href="#target-dependent-expressions" title="Permalink to this heading">¶</a></h3>
These queries refer to a target <code class="docutils literal notranslate">tgt</code>. Unless otherwise stated, this can
be any runtime artifact, namely:
<ul class="simple">
<li>An executable target created by <a class="reference internal" href="../command/add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a>.</li>
<li>A shared library target (<code class="docutils literal notranslate">.so</code>, <code class="docutils literal notranslate">.dll</code> but not their <code class="docutils literal notranslate">.lib</code> import
library) created by <a class="reference internal" href="../command/add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a>.</li>
<li>A static library target created by <a class="reference internal" href="../command/add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a>.</li>
</ul>
In the following, the phrase &quot;the <code class="docutils literal notranslate">tgt</code> filename&quot; means the name of the
<code class="docutils literal notranslate">tgt</code> binary file. This has to be distinguished from the phrase
&quot;the target name&quot;, which is just the string <code class="docutils literal notranslate">tgt</code>.
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_EXISTS">
$&lt;TARGET_EXISTS:tgt&gt;<a class="headerlink" href="#genex:TARGET_EXISTS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.12.
</div>
<code class="docutils literal notranslate">1</code> if <code class="docutils literal notranslate">tgt</code> exists as a CMake target, else <code class="docutils literal notranslate">0</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_NAME_IF_EXISTS">
$&lt;TARGET_NAME_IF_EXISTS:tgt&gt;<a class="headerlink" href="#genex:TARGET_NAME_IF_EXISTS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.12.
</div>
The target name <code class="docutils literal notranslate">tgt</code> if the target exists, an empty string otherwise.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_NAME">
$&lt;TARGET_NAME:...&gt;<a class="headerlink" href="#genex:TARGET_NAME" title="Permalink to this definition">¶</a></dt>
<dd>Marks <code class="docutils literal notranslate">...</code> as being the name of a target. This is required if exporting
targets to multiple dependent export sets. The <code class="docutils literal notranslate">...</code> must be a literal
name of a target, it may not contain generator expressions.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_PROPERTY">
$&lt;TARGET_PROPERTY:tgt,prop&gt;<a class="headerlink" href="#genex:TARGET_PROPERTY" title="Permalink to this definition">¶</a></dt>
<dd>Value of the property <code class="docutils literal notranslate">prop</code> on the target <code class="docutils literal notranslate">tgt</code>.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
<div class="versionchanged">
Changed in version 3.26: When encountered during evaluation of <a class="reference internal" href="cmake-buildsystem.7.html#target-usage-requirements">Transitive Usage Requirements</a>,
typically in an <code class="docutils literal notranslate">INTERFACE_*</code> target property, lookup of the <code class="docutils literal notranslate">tgt</code>
name occurs in the directory of the target specifying the requirement,
rather than the directory of the consuming target for which the
expression is being evaluated.
</div>
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake">
$&lt;TARGET_PROPERTY:prop&gt;</dt>
<dd>Value of the property <code class="docutils literal notranslate">prop</code> on the target for which the expression
is being evaluated. Note that for generator expressions in
<a class="reference internal" href="cmake-buildsystem.7.html#target-usage-requirements">Transitive Usage Requirements</a> this is the consuming target rather
than the target specifying the requirement.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_OBJECTS">
$&lt;TARGET_OBJECTS:tgt&gt;<a class="headerlink" href="#genex:TARGET_OBJECTS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
List of objects resulting from building <code class="docutils literal notranslate">tgt</code>. This would typically be
used on <a class="reference internal" href="cmake-buildsystem.7.html#object-libraries">object library</a> targets.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_POLICY">
$&lt;TARGET_POLICY:policy&gt;<a class="headerlink" href="#genex:TARGET_POLICY" title="Permalink to this definition">¶</a></dt>
<dd><code class="docutils literal notranslate">1</code> if the <code class="docutils literal notranslate">policy</code> was <code class="docutils literal notranslate">NEW</code> when the 'head' target was created,
else <code class="docutils literal notranslate">0</code>. If the <code class="docutils literal notranslate">policy</code> was not set, the warning message for the policy
will be emitted. This generator expression only works for a subset of
policies.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE">
$&lt;TARGET_FILE:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE" title="Permalink to this definition">¶</a></dt>
<dd>Full path to the <code class="docutils literal notranslate">tgt</code> binary file.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on, unless the expression is being used in
<a class="reference internal" href="../command/add_custom_command.html#command:add_custom_command" title="add_custom_command"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_command()</code></a> or <a class="reference internal" href="../command/add_custom_target.html#command:add_custom_target" title="add_custom_target"><code class="xref cmake cmake-command docutils literal notranslate">add_custom_target()</code></a>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE_BASE_NAME">
$&lt;TARGET_FILE_BASE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE_BASE_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Base name of <code class="docutils literal notranslate">tgt</code>, i.e. <code class="docutils literal notranslate">$&lt;TARGET_FILE_NAME:tgt&gt;</code> without prefix and
suffix.
For example, if the <code class="docutils literal notranslate">tgt</code> filename is <code class="docutils literal notranslate">libbase.so</code>, the base name is <code class="docutils literal notranslate">base</code>.
See also the <a class="reference internal" href="../prop_tgt/OUTPUT_NAME.html#prop_tgt:OUTPUT_NAME" title="OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME</code></a>, <a class="reference internal" href="../prop_tgt/ARCHIVE_OUTPUT_NAME.html#prop_tgt:ARCHIVE_OUTPUT_NAME" title="ARCHIVE_OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ARCHIVE_OUTPUT_NAME</code></a>,
<a class="reference internal" href="../prop_tgt/LIBRARY_OUTPUT_NAME.html#prop_tgt:LIBRARY_OUTPUT_NAME" title="LIBRARY_OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LIBRARY_OUTPUT_NAME</code></a> and <a class="reference internal" href="../prop_tgt/RUNTIME_OUTPUT_NAME.html#prop_tgt:RUNTIME_OUTPUT_NAME" title="RUNTIME_OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">RUNTIME_OUTPUT_NAME</code></a>
target properties and their configuration specific variants
<a class="reference internal" href="../prop_tgt/OUTPUT_NAME_CONFIG.html#prop_tgt:OUTPUT_NAME_&lt;CONFIG&gt;" title="OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME_&lt;CONFIG&gt;</code></a>, <a class="reference internal" href="../prop_tgt/ARCHIVE_OUTPUT_NAME_CONFIG.html#prop_tgt:ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;" title="ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;</code></a>,
<a class="reference internal" href="../prop_tgt/LIBRARY_OUTPUT_NAME_CONFIG.html#prop_tgt:LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;" title="LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;</code></a> and
<a class="reference internal" href="../prop_tgt/RUNTIME_OUTPUT_NAME_CONFIG.html#prop_tgt:RUNTIME_OUTPUT_NAME_&lt;CONFIG&gt;" title="RUNTIME_OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">RUNTIME_OUTPUT_NAME_&lt;CONFIG&gt;</code></a>.
The <a class="reference internal" href="../prop_tgt/CONFIG_POSTFIX.html#prop_tgt:&lt;CONFIG&gt;_POSTFIX" title="&lt;CONFIG&gt;_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;CONFIG&gt;_POSTFIX</code></a> and <a class="reference internal" href="../prop_tgt/DEBUG_POSTFIX.html#prop_tgt:DEBUG_POSTFIX" title="DEBUG_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">DEBUG_POSTFIX</code></a> target
properties can also be considered.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE_PREFIX">
$&lt;TARGET_FILE_PREFIX:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE_PREFIX" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Prefix of the <code class="docutils literal notranslate">tgt</code> filename (such as <code class="docutils literal notranslate">lib</code>).
See also the <a class="reference internal" href="../prop_tgt/PREFIX.html#prop_tgt:PREFIX" title="PREFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PREFIX</code></a> target property.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE_SUFFIX">
$&lt;TARGET_FILE_SUFFIX:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE_SUFFIX" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Suffix of the <code class="docutils literal notranslate">tgt</code> filename (extension such as <code class="docutils literal notranslate">.so</code> or <code class="docutils literal notranslate">.exe</code>).
See also the <a class="reference internal" href="../prop_tgt/SUFFIX.html#prop_tgt:SUFFIX" title="SUFFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SUFFIX</code></a> target property.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE_NAME">
$&lt;TARGET_FILE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dd>The <code class="docutils literal notranslate">tgt</code> filename.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_FILE_DIR">
$&lt;TARGET_FILE_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_FILE_DIR" title="Permalink to this definition">¶</a></dt>
<dd>Directory of the <code class="docutils literal notranslate">tgt</code> binary file.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE">
$&lt;TARGET_LINKER_FILE:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE" title="Permalink to this definition">¶</a></dt>
<dd>File used when linking to the <code class="docutils literal notranslate">tgt</code> target. This will usually
be the library that <code class="docutils literal notranslate">tgt</code> represents (<code class="docutils literal notranslate">.a</code>, <code class="docutils literal notranslate">.lib</code>, <code class="docutils literal notranslate">.so</code>),
but for a shared library on DLL platforms, it would be the <code class="docutils literal notranslate">.lib</code>
import library associated with the DLL.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE_BASE_NAME">
$&lt;TARGET_LINKER_FILE_BASE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE_BASE_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Base name of file used to link the target <code class="docutils literal notranslate">tgt</code>, i.e.
<code class="docutils literal notranslate">$&lt;TARGET_LINKER_FILE_NAME:tgt&gt;</code> without prefix and suffix. For example,
if target file name is <code class="docutils literal notranslate">libbase.a</code>, the base name is <code class="docutils literal notranslate">base</code>.
See also the <a class="reference internal" href="../prop_tgt/OUTPUT_NAME.html#prop_tgt:OUTPUT_NAME" title="OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME</code></a>, <a class="reference internal" href="../prop_tgt/ARCHIVE_OUTPUT_NAME.html#prop_tgt:ARCHIVE_OUTPUT_NAME" title="ARCHIVE_OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ARCHIVE_OUTPUT_NAME</code></a>,
and <a class="reference internal" href="../prop_tgt/LIBRARY_OUTPUT_NAME.html#prop_tgt:LIBRARY_OUTPUT_NAME" title="LIBRARY_OUTPUT_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LIBRARY_OUTPUT_NAME</code></a> target properties and their configuration
specific variants <a class="reference internal" href="../prop_tgt/OUTPUT_NAME_CONFIG.html#prop_tgt:OUTPUT_NAME_&lt;CONFIG&gt;" title="OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">OUTPUT_NAME_&lt;CONFIG&gt;</code></a>,
<a class="reference internal" href="../prop_tgt/ARCHIVE_OUTPUT_NAME_CONFIG.html#prop_tgt:ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;" title="ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">ARCHIVE_OUTPUT_NAME_&lt;CONFIG&gt;</code></a> and
<a class="reference internal" href="../prop_tgt/LIBRARY_OUTPUT_NAME_CONFIG.html#prop_tgt:LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;" title="LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">LIBRARY_OUTPUT_NAME_&lt;CONFIG&gt;</code></a>.
The <a class="reference internal" href="../prop_tgt/CONFIG_POSTFIX.html#prop_tgt:&lt;CONFIG&gt;_POSTFIX" title="&lt;CONFIG&gt;_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;CONFIG&gt;_POSTFIX</code></a> and <a class="reference internal" href="../prop_tgt/DEBUG_POSTFIX.html#prop_tgt:DEBUG_POSTFIX" title="DEBUG_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">DEBUG_POSTFIX</code></a> target
properties can also be considered.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE_PREFIX">
$&lt;TARGET_LINKER_FILE_PREFIX:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE_PREFIX" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Prefix of file used to link target <code class="docutils literal notranslate">tgt</code>.
See also the <a class="reference internal" href="../prop_tgt/PREFIX.html#prop_tgt:PREFIX" title="PREFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PREFIX</code></a> and <a class="reference internal" href="../prop_tgt/IMPORT_PREFIX.html#prop_tgt:IMPORT_PREFIX" title="IMPORT_PREFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORT_PREFIX</code></a> target
properties.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE_SUFFIX">
$&lt;TARGET_LINKER_FILE_SUFFIX:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE_SUFFIX" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Suffix of file used to link where <code class="docutils literal notranslate">tgt</code> is the name of a target.
The suffix corresponds to the file extension (such as &quot;.so&quot; or &quot;.lib&quot;).
See also the <a class="reference internal" href="../prop_tgt/SUFFIX.html#prop_tgt:SUFFIX" title="SUFFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">SUFFIX</code></a> and <a class="reference internal" href="../prop_tgt/IMPORT_SUFFIX.html#prop_tgt:IMPORT_SUFFIX" title="IMPORT_SUFFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORT_SUFFIX</code></a> target
properties.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE_NAME">
$&lt;TARGET_LINKER_FILE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dd>Name of file used to link target <code class="docutils literal notranslate">tgt</code>.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_LINKER_FILE_DIR">
$&lt;TARGET_LINKER_FILE_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_LINKER_FILE_DIR" title="Permalink to this definition">¶</a></dt>
<dd>Directory of file used to link target <code class="docutils literal notranslate">tgt</code>.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_SONAME_FILE">
$&lt;TARGET_SONAME_FILE:tgt&gt;<a class="headerlink" href="#genex:TARGET_SONAME_FILE" title="Permalink to this definition">¶</a></dt>
<dd>File with soname (<code class="docutils literal notranslate">.so.3</code>) where <code class="docutils literal notranslate">tgt</code> is the name of a target.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_SONAME_FILE_NAME">
$&lt;TARGET_SONAME_FILE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_SONAME_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dd>Name of file with soname (<code class="docutils literal notranslate">.so.3</code>).
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_SONAME_FILE_DIR">
$&lt;TARGET_SONAME_FILE_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_SONAME_FILE_DIR" title="Permalink to this definition">¶</a></dt>
<dd>Directory of with soname (<code class="docutils literal notranslate">.so.3</code>).
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_PDB_FILE">
$&lt;TARGET_PDB_FILE:tgt&gt;<a class="headerlink" href="#genex:TARGET_PDB_FILE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
Full path to the linker generated program database file (.pdb)
where <code class="docutils literal notranslate">tgt</code> is the name of a target.
See also the <a class="reference internal" href="../prop_tgt/PDB_NAME.html#prop_tgt:PDB_NAME" title="PDB_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_NAME</code></a> and <a class="reference internal" href="../prop_tgt/PDB_OUTPUT_DIRECTORY.html#prop_tgt:PDB_OUTPUT_DIRECTORY" title="PDB_OUTPUT_DIRECTORY"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_OUTPUT_DIRECTORY</code></a>
target properties and their configuration specific variants
<a class="reference internal" href="../prop_tgt/PDB_NAME_CONFIG.html#prop_tgt:PDB_NAME_&lt;CONFIG&gt;" title="PDB_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_NAME_&lt;CONFIG&gt;</code></a> and <a class="reference internal" href="../prop_tgt/PDB_OUTPUT_DIRECTORY_CONFIG.html#prop_tgt:PDB_OUTPUT_DIRECTORY_&lt;CONFIG&gt;" title="PDB_OUTPUT_DIRECTORY_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_OUTPUT_DIRECTORY_&lt;CONFIG&gt;</code></a>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_PDB_FILE_BASE_NAME">
$&lt;TARGET_PDB_FILE_BASE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_PDB_FILE_BASE_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.15.
</div>
Base name of the linker generated program database file (.pdb)
where <code class="docutils literal notranslate">tgt</code> is the name of a target.
The base name corresponds to the target PDB file name (see
<code class="docutils literal notranslate">$&lt;TARGET_PDB_FILE_NAME:tgt&gt;</code>) without prefix and suffix. For example,
if target file name is <code class="docutils literal notranslate">base.pdb</code>, the base name is <code class="docutils literal notranslate">base</code>.
See also the <a class="reference internal" href="../prop_tgt/PDB_NAME.html#prop_tgt:PDB_NAME" title="PDB_NAME"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_NAME</code></a> target property and its configuration
specific variant <a class="reference internal" href="../prop_tgt/PDB_NAME_CONFIG.html#prop_tgt:PDB_NAME_&lt;CONFIG&gt;" title="PDB_NAME_&lt;CONFIG&gt;"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">PDB_NAME_&lt;CONFIG&gt;</code></a>.
The <a class="reference internal" href="../prop_tgt/CONFIG_POSTFIX.html#prop_tgt:&lt;CONFIG&gt;_POSTFIX" title="&lt;CONFIG&gt;_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">&lt;CONFIG&gt;_POSTFIX</code></a> and <a class="reference internal" href="../prop_tgt/DEBUG_POSTFIX.html#prop_tgt:DEBUG_POSTFIX" title="DEBUG_POSTFIX"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">DEBUG_POSTFIX</code></a> target
properties can also be considered.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_PDB_FILE_NAME">
$&lt;TARGET_PDB_FILE_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_PDB_FILE_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
Name of the linker generated program database file (.pdb).
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_PDB_FILE_DIR">
$&lt;TARGET_PDB_FILE_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_PDB_FILE_DIR" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.1.
</div>
Directory of the linker generated program database file (.pdb).
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_BUNDLE_DIR">
$&lt;TARGET_BUNDLE_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_BUNDLE_DIR" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.9.
</div>
Full path to the bundle directory (<code class="docutils literal notranslate">/path/to/my.app</code>,
<code class="docutils literal notranslate">/path/to/my.framework</code>, or <code class="docutils literal notranslate">/path/to/my.bundle</code>),
where <code class="docutils literal notranslate">tgt</code> is the name of a target.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_BUNDLE_DIR_NAME">
$&lt;TARGET_BUNDLE_DIR_NAME:tgt&gt;<a class="headerlink" href="#genex:TARGET_BUNDLE_DIR_NAME" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.24.
</div>
Name of the bundle directory (<code class="docutils literal notranslate">my.app</code>, <code class="docutils literal notranslate">my.framework</code>, or
<code class="docutils literal notranslate">my.bundle</code>), where <code class="docutils literal notranslate">tgt</code> is the name of a target.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_BUNDLE_CONTENT_DIR">
$&lt;TARGET_BUNDLE_CONTENT_DIR:tgt&gt;<a class="headerlink" href="#genex:TARGET_BUNDLE_CONTENT_DIR" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.9.
</div>
Full path to the bundle content directory where <code class="docutils literal notranslate">tgt</code> is the name of a
target. For the macOS SDK it leads to <code class="docutils literal notranslate">/path/to/my.app/Contents</code>,
<code class="docutils literal notranslate">/path/to/my.framework</code>, or <code class="docutils literal notranslate">/path/to/my.bundle/Contents</code>.
For all other SDKs (e.g. iOS) it leads to <code class="docutils literal notranslate">/path/to/my.app</code>,
<code class="docutils literal notranslate">/path/to/my.framework</code>, or <code class="docutils literal notranslate">/path/to/my.bundle</code> due to the flat
bundle structure.
Note that <code class="docutils literal notranslate">tgt</code> is not added as a dependency of the target this
expression is evaluated on (see policy <a class="reference internal" href="../policy/CMP0112.html#policy:CMP0112" title="CMP0112"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0112</code></a>).
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_RUNTIME_DLLS">
$&lt;TARGET_RUNTIME_DLLS:tgt&gt;<a class="headerlink" href="#genex:TARGET_RUNTIME_DLLS" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.21.
</div>
List of DLLs that the target depends on at runtime. This is determined by
the locations of all the <code class="docutils literal notranslate">SHARED</code> targets in the target's transitive
dependencies. Using this generator expression on targets other than
executables, <code class="docutils literal notranslate">SHARED</code> libraries, and <code class="docutils literal notranslate">MODULE</code> libraries is an error.
On non-DLL platforms, this expression always evaluates to an empty string.
This generator expression can be used to copy all of the DLLs that a target
depends on into its output directory in a <code class="docutils literal notranslate">POST_BUILD</code> custom command using
the <a class="reference internal" href="cmake.1.html#cmdoption-cmake-E-arg-copy"><code class="xref std std-option docutils literal notranslate">cmake -E copy -t</code></a> command. For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>find_package(foo CONFIG REQUIRED) # package generated by install(EXPORT)

add_executable(exe main.c)
target_link_libraries(exe PRIVATE foo::foo foo::bar)
add_custom_command(TARGET exe POST_BUILD
 COMMAND ${CMAKE_COMMAND} -E copy -t $&lt;TARGET_FILE_DIR:exe&gt; $&lt;TARGET_RUNTIME_DLLS:exe&gt;
 COMMAND_EXPAND_LISTS
)
</pre></div>
</div>
<div class="admonition note">
Note
<a class="reference internal" href="cmake-buildsystem.7.html#imported-targets">Imported Targets</a> are supported only if they know the location
of their <code class="docutils literal notranslate">.dll</code> files. An imported <code class="docutils literal notranslate">SHARED</code> library must have
<a class="reference internal" href="../prop_tgt/IMPORTED_LOCATION.html#prop_tgt:IMPORTED_LOCATION" title="IMPORTED_LOCATION"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">IMPORTED_LOCATION</code></a> set to its <code class="docutils literal notranslate">.dll</code> file. See the
<a class="reference internal" href="../command/add_library.html#add-library-imported-libraries">add_library imported libraries</a>
section for details. Many <a class="reference internal" href="cmake-developer.7.html#find-modules">Find Modules</a> produce imported targets
with the <code class="docutils literal notranslate">UNKNOWN</code> type and therefore will be ignored.
</div>
</dd></dl>

On platforms that support runtime paths (<code class="docutils literal notranslate">RPATH</code>), refer to the
<a class="reference internal" href="../prop_tgt/INSTALL_RPATH.html#prop_tgt:INSTALL_RPATH" title="INSTALL_RPATH"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INSTALL_RPATH</code></a> target property.
On Apple platforms, refer to the <a class="reference internal" href="../prop_tgt/INSTALL_NAME_DIR.html#prop_tgt:INSTALL_NAME_DIR" title="INSTALL_NAME_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INSTALL_NAME_DIR</code></a> target property.
</section>
<section id="export-and-install-expressions">
<h3><a class="toc-backref" href="#id29" role="doc-backlink">Export And Install Expressions</a><a class="headerlink" href="#export-and-install-expressions" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:INSTALL_INTERFACE">
$&lt;INSTALL_INTERFACE:...&gt;<a class="headerlink" href="#genex:INSTALL_INTERFACE" title="Permalink to this definition">¶</a></dt>
<dd>Content of <code class="docutils literal notranslate">...</code> when the property is exported using
<a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(EXPORT)</code></a>, and empty otherwise.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:BUILD_INTERFACE">
$&lt;BUILD_INTERFACE:...&gt;<a class="headerlink" href="#genex:BUILD_INTERFACE" title="Permalink to this definition">¶</a></dt>
<dd>Content of <code class="docutils literal notranslate">...</code> when the property is exported using <a class="reference internal" href="../command/export.html#command:export" title="export"><code class="xref cmake cmake-command docutils literal notranslate">export()</code></a>, or
when the target is used by another target in the same buildsystem. Expands to
the empty string otherwise.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:BUILD_LOCAL_INTERFACE">
$&lt;BUILD_LOCAL_INTERFACE:...&gt;<a class="headerlink" href="#genex:BUILD_LOCAL_INTERFACE" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.26.
</div>
Content of <code class="docutils literal notranslate">...</code> when the target is used by another target in the same
buildsystem. Expands to the empty string otherwise.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:INSTALL_PREFIX">
$&lt;INSTALL_PREFIX&gt;<a class="headerlink" href="#genex:INSTALL_PREFIX" title="Permalink to this definition">¶</a></dt>
<dd>Content of the install prefix when the target is exported via
<a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(EXPORT)</code></a>, or when evaluated in the
<a class="reference internal" href="../prop_tgt/INSTALL_NAME_DIR.html#prop_tgt:INSTALL_NAME_DIR" title="INSTALL_NAME_DIR"><code class="xref cmake cmake-prop_tgt docutils literal notranslate">INSTALL_NAME_DIR</code></a> property or the <code class="docutils literal notranslate">INSTALL_NAME_DIR</code> argument of
<a class="reference internal" href="../command/install.html#command:install" title="install"><code class="xref cmake cmake-command docutils literal notranslate">install(RUNTIME_DEPENDENCY_SET)</code></a>, and empty otherwise.
</dd></dl>

</section>
<section id="multi-level-expression-evaluation">
<h3><a class="toc-backref" href="#id30" role="doc-backlink">Multi-level Expression Evaluation</a><a class="headerlink" href="#multi-level-expression-evaluation" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:GENEX_EVAL">
$&lt;GENEX_EVAL:expr&gt;<a class="headerlink" href="#genex:GENEX_EVAL" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.12.
</div>
Content of <code class="docutils literal notranslate">expr</code> evaluated as a generator expression in the current
context. This enables consumption of generator expressions whose
evaluation results itself in generator expressions.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:TARGET_GENEX_EVAL">
$&lt;TARGET_GENEX_EVAL:tgt,expr&gt;<a class="headerlink" href="#genex:TARGET_GENEX_EVAL" title="Permalink to this definition">¶</a></dt>
<dd><div class="versionadded">
New in version 3.12.
</div>
Content of <code class="docutils literal notranslate">expr</code> evaluated as a generator expression in the context of
<code class="docutils literal notranslate">tgt</code> target. This enables consumption of custom target properties that
themselves contain generator expressions.
Having the capability to evaluate generator expressions is very useful when
you want to manage custom properties supporting generator expressions.
For example:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_library(foo ...)

set_property(TARGET foo PROPERTY
 CUSTOM_KEYS $&lt;$&lt;CONFIG:DEBUG&gt;:FOO_EXTRA_THINGS&gt;
)

add_custom_target(printFooKeys
 COMMAND ${CMAKE_COMMAND} -E echo $&lt;TARGET_PROPERTY:foo,CUSTOM_KEYS&gt;
)
</pre></div>
</div>
This naive implementation of the <code class="docutils literal notranslate">printFooKeys</code> custom command is wrong
because <code class="docutils literal notranslate">CUSTOM_KEYS</code> target property is not evaluated and the content
is passed as is (i.e. <code class="docutils literal notranslate">$&lt;$&lt;CONFIG:DEBUG&gt;:FOO_EXTRA_THINGS&gt;</code>).
To have the expected result (i.e. <code class="docutils literal notranslate">FOO_EXTRA_THINGS</code> if config is
<code class="docutils literal notranslate">Debug</code>), it is required to evaluate the output of
<code class="docutils literal notranslate">$&lt;TARGET_PROPERTY:foo,CUSTOM_KEYS&gt;</code>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre>add_custom_target(printFooKeys
 COMMAND ${CMAKE_COMMAND} -E
 echo $&lt;TARGET_GENEX_EVAL:foo,$&lt;TARGET_PROPERTY:foo,CUSTOM_KEYS&gt;&gt;
)
</pre></div>
</div>
</dd></dl>

</section>
<section id="escaped-characters">
<h3><a class="toc-backref" href="#id31" role="doc-backlink">Escaped Characters</a><a class="headerlink" href="#escaped-characters" title="Permalink to this heading">¶</a></h3>
These expressions evaluate to specific string literals. Use them in place of
the actual string literal where you need to prevent them from having their
special meaning.
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:ANGLE-R">
$&lt;ANGLE-R&gt;<a class="headerlink" href="#genex:ANGLE-R" title="Permalink to this definition">¶</a></dt>
<dd>A literal <code class="docutils literal notranslate">&gt;</code>. Used for example to compare strings that contain a <code class="docutils literal notranslate">&gt;</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:COMMA">
$&lt;COMMA&gt;<a class="headerlink" href="#genex:COMMA" title="Permalink to this definition">¶</a></dt>
<dd>A literal <code class="docutils literal notranslate">,</code>. Used for example to compare strings which contain a <code class="docutils literal notranslate">,</code>.
</dd></dl>

<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:SEMICOLON">
$&lt;SEMICOLON&gt;<a class="headerlink" href="#genex:SEMICOLON" title="Permalink to this definition">¶</a></dt>
<dd>A literal <code class="docutils literal notranslate">;</code>. Used to prevent list expansion on an argument with <code class="docutils literal notranslate">;</code>.
</dd></dl>

</section>
<section id="deprecated-expressions">
<h3><a class="toc-backref" href="#id32" role="doc-backlink">Deprecated Expressions</a><a class="headerlink" href="#deprecated-expressions" title="Permalink to this heading">¶</a></h3>
<dl class="cmake genex">
<dt class="sig sig-object cmake" id="genex:CONFIGURATION">
$&lt;CONFIGURATION&gt;<a class="headerlink" href="#genex:CONFIGURATION" title="Permalink to this definition">¶</a></dt>
<dd>Configuration name. Deprecated since CMake 3.0. Use <a class="reference internal" href="#genex:CONFIG" title="CONFIG"><code class="xref cmake cmake-genex docutils literal notranslate">CONFIG</code></a> instead.
</dd></dl>

</section>
</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-generator-expressions(7)</a><ul>
<li><a class="reference internal" href="#introduction">Introduction</a></li>
<li><a class="reference internal" href="#whitespace-and-quoting">Whitespace And Quoting</a></li>
<li><a class="reference internal" href="#debugging">Debugging</a></li>
<li><a class="reference internal" href="#generator-expression-reference">Generator Expression Reference</a><ul>
<li><a class="reference internal" href="#conditional-expressions">Conditional Expressions</a></li>
<li><a class="reference internal" href="#logical-operators">Logical Operators</a></li>
<li><a class="reference internal" href="#primary-comparison-expressions">Primary Comparison Expressions</a><ul>
<li><a class="reference internal" href="#string-comparisons">String Comparisons</a></li>
<li><a class="reference internal" href="#version-comparisons">Version Comparisons</a></li>
</ul>
</li>
<li><a class="reference internal" href="#string-transformations">String Transformations</a></li>
<li><a class="reference internal" href="#list-expressions">List Expressions</a></li>
<li><a class="reference internal" href="#path-expressions">Path Expressions</a><ul>
<li><a class="reference internal" href="#path-comparisons">Path Comparisons</a></li>
<li><a class="reference internal" href="#path-queries">Path Queries</a></li>
<li><a class="reference internal" href="#path-decomposition">Path Decomposition</a></li>
<li><a class="reference internal" href="#path-transformations">Path Transformations</a></li>
<li><a class="reference internal" href="#shell-paths">Shell Paths</a></li>
</ul>
</li>
<li><a class="reference internal" href="#configuration-expressions">Configuration Expressions</a></li>
<li><a class="reference internal" href="#toolchain-and-language-expressions">Toolchain And Language Expressions</a><ul>
<li><a class="reference internal" href="#platform">Platform</a></li>
<li><a class="reference internal" href="#compiler-version">Compiler Version</a></li>
<li><a class="reference internal" href="#compiler-language-and-id">Compiler Language And ID</a></li>
<li><a class="reference internal" href="#compile-features">Compile Features</a></li>
<li><a class="reference internal" href="#linker-language-and-id">Linker Language And ID</a></li>
<li><a class="reference internal" href="#link-features">Link Features</a></li>
<li><a class="reference internal" href="#link-context">Link Context</a></li>
</ul>
</li>
<li><a class="reference internal" href="#target-dependent-expressions">Target-Dependent Expressions</a></li>
<li><a class="reference internal" href="#export-and-install-expressions">Export And Install Expressions</a></li>
<li><a class="reference internal" href="#multi-level-expression-evaluation">Multi-level Expression Evaluation</a></li>
<li><a class="reference internal" href="#escaped-characters">Escaped Characters</a></li>
<li><a class="reference internal" href="#deprecated-expressions">Deprecated Expressions</a></li>
</ul>
</li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="cmake-file-api.7.html"
 title="previous chapter">cmake-file-api(7)</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="cmake-generators.7.html"
 title="next chapter">cmake-generators(7)</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/manual/cmake-generator-expressions.7.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-generators.7.html" title="cmake-generators(7)"
 >next</a> |</li>
 <li class="right" >
 <a href="cmake-file-api.7.html" title="cmake-file-api(7)"
 >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-this"><a href="">cmake-generator-expressions(7)</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>