OXIESEC PANEL

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

Editing: if.html

<!DOCTYPE html>

<title>if &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="include.html" title="include"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="get_property.html" title="get_property"
 accesskey="P">previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

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

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="if">
<h1>if<a class="headerlink" href="#if" title="Permalink to this heading">¶</a></h1>
Conditionally execute a group of commands.
<section id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate"><div class="highlight"><pre>if(&lt;condition&gt;)
 &lt;commands&gt;
elseif(&lt;condition&gt;) # optional block, can be repeated
 &lt;commands&gt;
else() # optional block
 &lt;commands&gt;
endif()
</pre></div>
</div>
Evaluates the <code class="docutils literal notranslate">condition</code> argument of the <code class="docutils literal notranslate">if</code> clause according to the
<a class="reference internal" href="#condition-syntax">Condition syntax</a> described below. If the result is true, then the
<code class="docutils literal notranslate">commands</code> in the <code class="docutils literal notranslate">if</code> block are executed.
Otherwise, optional <code class="docutils literal notranslate">elseif</code> blocks are processed in the same way.
Finally, if no <code class="docutils literal notranslate">condition</code> is true, <code class="docutils literal notranslate">commands</code> in the optional <code class="docutils literal notranslate">else</code>
block are executed.
Per legacy, the <a class="reference internal" href="else.html#command:else" title="else"><code class="xref cmake cmake-command docutils literal notranslate">else()</code></a> and <a class="reference internal" href="endif.html#command:endif" title="endif"><code class="xref cmake cmake-command docutils literal notranslate">endif()</code></a> commands admit
an optional <code class="docutils literal notranslate">&lt;condition&gt;</code> argument.
If used, it must be a verbatim
repeat of the argument of the opening
<code class="docutils literal notranslate">if</code> command.
</section>
<section id="condition-syntax">
<h2>Condition Syntax<a class="headerlink" href="#condition-syntax" title="Permalink to this heading">¶</a></h2>
The following syntax applies to the <code class="docutils literal notranslate">condition</code> argument of
the <code class="docutils literal notranslate">if</code>, <code class="docutils literal notranslate">elseif</code> and <a class="reference internal" href="while.html#command:while" title="while"><code class="xref cmake cmake-command docutils literal notranslate">while()</code></a> clauses.
Compound conditions are evaluated in the following order of precedence:
<ol class="arabic simple">
<li>Parentheses.</li>
<li>Unary tests such as <a class="reference internal" href="#exists">EXISTS</a>, <a class="reference internal" href="#command">COMMAND</a>, and <a class="reference internal" href="#defined">DEFINED</a>.</li>
<li>Binary tests such as <a class="reference internal" href="#equal">EQUAL</a>, <a class="reference internal" href="#less">LESS</a>, <a class="reference internal" href="#less-equal">LESS_EQUAL</a>, <a class="reference internal" href="#greater">GREATER</a>,
<a class="reference internal" href="#greater-equal">GREATER_EQUAL</a>, <a class="reference internal" href="#strequal">STREQUAL</a>, <a class="reference internal" href="#strless">STRLESS</a>, <a class="reference internal" href="#strless-equal">STRLESS_EQUAL</a>,
<a class="reference internal" href="#strgreater">STRGREATER</a>, <a class="reference internal" href="#strgreater-equal">STRGREATER_EQUAL</a>, <a class="reference internal" href="#version-equal">VERSION_EQUAL</a>, <a class="reference internal" href="#version-less">VERSION_LESS</a>,
<a class="reference internal" href="#version-less-equal">VERSION_LESS_EQUAL</a>, <a class="reference internal" href="#version-greater">VERSION_GREATER</a>, <a class="reference internal" href="#version-greater-equal">VERSION_GREATER_EQUAL</a>,
<a class="reference internal" href="#path-equal">PATH_EQUAL</a>, and <a class="reference internal" href="#matches">MATCHES</a>.</li>
<li>Unary logical operator <a class="reference internal" href="#not">NOT</a>.</li>
<li>Binary logical operators <a class="reference internal" href="#and">AND</a> and <a class="reference internal" href="#or">OR</a>, from left to right,
without any short-circuit.</li>
</ol>
<section id="basic-expressions">
<h3>Basic Expressions<a class="headerlink" href="#basic-expressions" title="Permalink to this heading">¶</a></h3>
<dl class="simple">
<dt><code class="docutils literal notranslate">if(&lt;constant&gt;)</code></dt><dd>True if the constant is <code class="docutils literal notranslate">1</code>, <code class="docutils literal notranslate">ON</code>, <code class="docutils literal notranslate">YES</code>, <code class="docutils literal notranslate">TRUE</code>, <code class="docutils literal notranslate">Y</code>,
or a non-zero number (including floating point numbers).
False if the constant is <code class="docutils literal notranslate">0</code>, <code class="docutils literal notranslate">OFF</code>,
<code class="docutils literal notranslate">NO</code>, <code class="docutils literal notranslate">FALSE</code>, <code class="docutils literal notranslate">N</code>, <code class="docutils literal notranslate">IGNORE</code>, <code class="docutils literal notranslate">NOTFOUND</code>, the empty string,
or ends in the suffix <code class="docutils literal notranslate">-NOTFOUND</code>. Named boolean constants are
case-insensitive. If the argument is not one of these specific
constants, it is treated as a variable or string (see <a class="reference internal" href="#variable-expansion">Variable Expansion</a>
further below) and one of the following two forms applies.
</dd>
<dt><code class="docutils literal notranslate">if(&lt;variable&gt;)</code></dt><dd>True if given a variable that is defined to a value that is not a false
constant. False otherwise, including if the variable is undefined.
Note that macro arguments are not variables.
<a class="reference internal" href="../manual/cmake-language.7.html#cmake-language-environment-variables">Environment Variables</a> also
cannot be tested this way, e.g. <code class="docutils literal notranslate">if(ENV{some_var})</code> will always evaluate
to false.
</dd>
<dt><code class="docutils literal notranslate">if(&lt;string&gt;)</code></dt><dd>A quoted string always evaluates to false unless:
<ul class="simple">
<li>The string's value is one of the true constants, or</li>
<li>Policy <a class="reference internal" href="../policy/CMP0054.html#policy:CMP0054" title="CMP0054"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0054</code></a> is not set to <code class="docutils literal notranslate">NEW</code> and the string's value
happens to be a variable name that is affected by <a class="reference internal" href="../policy/CMP0054.html#policy:CMP0054" title="CMP0054"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0054</code></a>'s
behavior.</li>
</ul>
</dd>
</dl>
</section>
<section id="logic-operators">
<h3>Logic Operators<a class="headerlink" href="#logic-operators" title="Permalink to this heading">¶</a></h3>
<dl class="simple" id="not">
<dt><code class="docutils literal notranslate">if(NOT &lt;condition&gt;)</code></dt><dd>True if the condition is not true.
</dd>
</dl>
<dl class="simple" id="and">
<dt><code class="docutils literal notranslate">if(&lt;cond1&gt; AND &lt;cond2&gt;)</code></dt><dd>True if both conditions would be considered true individually.
</dd>
</dl>
<dl class="simple" id="or">
<dt><code class="docutils literal notranslate">if(&lt;cond1&gt; OR &lt;cond2&gt;)</code></dt><dd>True if either condition would be considered true individually.
</dd>
<dt><code class="docutils literal notranslate">if((condition) AND (condition OR (condition)))</code></dt><dd>The conditions inside the parenthesis are evaluated first and then
the remaining condition is evaluated as in the other examples.
Where there are nested parenthesis the innermost are evaluated as part
of evaluating the condition that contains them.
</dd>
</dl>
</section>
<section id="existence-checks">
<h3>Existence Checks<a class="headerlink" href="#existence-checks" title="Permalink to this heading">¶</a></h3>
<dl id="command">
<dt><code class="docutils literal notranslate">if(COMMAND command-name)</code></dt><dd>True if the given name is a command, macro or function that can be
invoked.
</dd>
<dt><code class="docutils literal notranslate">if(POLICY policy-id)</code></dt><dd>True if the given name is an existing policy (of the form <code class="docutils literal notranslate">CMP&lt;NNNN&gt;</code>).
</dd>
<dt><code class="docutils literal notranslate">if(TARGET target-name)</code></dt><dd>True if the given name is an existing logical target name created
by a call to the <a class="reference internal" href="add_executable.html#command:add_executable" title="add_executable"><code class="xref cmake cmake-command docutils literal notranslate">add_executable()</code></a>, <a class="reference internal" href="add_library.html#command:add_library" title="add_library"><code class="xref cmake cmake-command docutils literal notranslate">add_library()</code></a>,
or <a class="reference internal" href="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> command that has already been invoked
(in any directory).
</dd>
<dt><code class="docutils literal notranslate">if(TEST test-name)</code></dt><dd><div class="versionadded">
New in version 3.3: True if the given name is an existing test name created by the
<a class="reference internal" href="add_test.html#command:add_test" title="add_test"><code class="xref cmake cmake-command docutils literal notranslate">add_test()</code></a> command.
</div>
</dd>
</dl>
<dl id="defined">
<dt><code class="docutils literal notranslate">if(DEFINED &lt;name&gt;|CACHE{&lt;name&gt;}|ENV{&lt;name&gt;})</code></dt><dd>True if a variable, cache variable or environment variable
with given <code class="docutils literal notranslate">&lt;name&gt;</code> is defined. The value of the variable
does not matter. Note the following caveats:
<ul class="simple">
<li>Macro arguments are not variables.</li>
<li>It is not possible to test directly whether a <cite>&lt;name&gt;</cite> is a non-cache
variable. The expression <code class="docutils literal notranslate">if(DEFINED someName)</code> will evaluate to true
if either a cache or non-cache variable <code class="docutils literal notranslate">someName</code> exists. In
comparison, the expression <code class="docutils literal notranslate">if(DEFINED CACHE{someName})</code> will only
evaluate to true if a cache variable <code class="docutils literal notranslate">someName</code> exists. Both expressions
need to be tested if you need to know whether a non-cache variable exists:
<code class="docutils literal notranslate">if(DEFINED someName AND NOT DEFINED CACHE{someName})</code>.</li>
</ul>
<div class="versionadded">
New in version 3.14: Added support for <code class="docutils literal notranslate">CACHE{&lt;name&gt;}</code> variables.
</div>
</dd>
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; IN_LIST &lt;variable&gt;)</code></dt><dd><div class="versionadded">
New in version 3.3: True if the given element is contained in the named list variable.
</div>
</dd>
</dl>
</section>
<section id="file-operations">
<h3>File Operations<a class="headerlink" href="#file-operations" title="Permalink to this heading">¶</a></h3>
<dl id="exists">
<dt><code class="docutils literal notranslate">if(EXISTS path-to-file-or-directory)</code></dt><dd>True if the named file or directory exists. Behavior is well-defined
only for explicit full paths (a leading <code class="docutils literal notranslate">~/</code> is not expanded as
a home directory and is considered a relative path).
Resolves symbolic links, i.e. if the named file or directory is a
symbolic link, returns true if the target of the symbolic link exists.
False if the given path is an empty string.
</dd>
<dt><code class="docutils literal notranslate">if(file1 IS_NEWER_THAN file2)</code></dt><dd>True if <code class="docutils literal notranslate">file1</code> is newer than <code class="docutils literal notranslate">file2</code> or if one of the two files doesn't
exist. Behavior is well-defined only for full paths. If the file
time stamps are exactly the same, an <code class="docutils literal notranslate">IS_NEWER_THAN</code> comparison returns
true, so that any dependent build operations will occur in the event
of a tie. This includes the case of passing the same file name for
both file1 and file2.
</dd>
<dt><code class="docutils literal notranslate">if(IS_DIRECTORY path)</code></dt><dd>True if <code class="docutils literal notranslate">path</code> is a directory. Behavior is well-defined only
for full paths.
False if the given path is an empty string.
</dd>
<dt><code class="docutils literal notranslate">if(IS_SYMLINK file-name)</code></dt><dd>True if the given name is a symbolic link. Behavior is well-defined
only for full paths.
</dd>
<dt><code class="docutils literal notranslate">if(IS_ABSOLUTE path)</code></dt><dd>True if the given path is an absolute path. Note the following special
cases:
<ul class="simple">
<li>An empty <code class="docutils literal notranslate">path</code> evaluates to false.</li>
<li>On Windows hosts, any <code class="docutils literal notranslate">path</code> that begins with a drive letter and colon
(e.g. <code class="docutils literal notranslate">C:</code>), a forward slash or a backslash will evaluate to true.
This means a path like <code class="docutils literal notranslate">C:no\base\dir</code> will evaluate to true, even
though the non-drive part of the path is relative.</li>
<li>On non-Windows hosts, any <code class="docutils literal notranslate">path</code> that begins with a tilde (<code class="docutils literal notranslate">~</code>)
evaluates to true.</li>
</ul>
</dd>
</dl>
</section>
<section id="comparisons">
<h3>Comparisons<a class="headerlink" href="#comparisons" title="Permalink to this heading">¶</a></h3>
<dl id="matches">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; MATCHES regex)</code></dt><dd>True if the given string or variable's value matches the given regular
expression. See <a class="reference internal" href="string.html#regex-specification">Regex Specification</a> for regex format.
<div class="versionadded">
New in version 3.9: <code class="docutils literal notranslate">()</code> groups are captured in <a class="reference internal" href="../variable/CMAKE_MATCH_n.html#variable:CMAKE_MATCH_&lt;n&gt;" title="CMAKE_MATCH_&lt;n&gt;"><code class="xref cmake cmake-variable docutils literal notranslate">CMAKE_MATCH_&lt;n&gt;</code></a> variables.
</div>
</dd>
</dl>
<dl class="simple" id="less">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; LESS &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is a valid number and less
than that on the right.
</dd>
</dl>
<dl class="simple" id="greater">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; GREATER &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is a valid number and greater
than that on the right.
</dd>
</dl>
<dl class="simple" id="equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; EQUAL &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is a valid number and equal
to that on the right.
</dd>
</dl>
<dl id="less-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; LESS_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: True if the given string or variable's value is a valid number and less
than or equal to that on the right.
</div>
</dd>
</dl>
<dl id="greater-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; GREATER_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: True if the given string or variable's value is a valid number and greater
than or equal to that on the right.
</div>
</dd>
</dl>
<dl class="simple" id="strless">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; STRLESS &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is lexicographically less
than the string or variable on the right.
</dd>
</dl>
<dl class="simple" id="strgreater">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; STRGREATER &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is lexicographically greater
than the string or variable on the right.
</dd>
</dl>
<dl class="simple" id="strequal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; STREQUAL &lt;variable|string&gt;)</code></dt><dd>True if the given string or variable's value is lexicographically equal
to the string or variable on the right.
</dd>
</dl>
<dl id="strless-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; STRLESS_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: True if the given string or variable's value is lexicographically less
than or equal to the string or variable on the right.
</div>
</dd>
</dl>
<dl id="strgreater-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; STRGREATER_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: True if the given string or variable's value is lexicographically greater
than or equal to the string or variable on the right.
</div>
</dd>
</dl>
</section>
<section id="version-comparisons">
<h3>Version Comparisons<a class="headerlink" href="#version-comparisons" title="Permalink to this heading">¶</a></h3>
<dl class="simple" id="version-less">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; VERSION_LESS &lt;variable|string&gt;)</code></dt><dd>Component-wise integer version number comparison (version format is
<code class="docutils literal notranslate">major[.minor[.patch[.tweak]]]</code>, omitted components are treated as zero).
Any non-integer version component or non-integer trailing part of a version
component effectively truncates the string at that point.
</dd>
</dl>
<dl class="simple" id="version-greater">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; VERSION_GREATER &lt;variable|string&gt;)</code></dt><dd>Component-wise integer version number comparison (version format is
<code class="docutils literal notranslate">major[.minor[.patch[.tweak]]]</code>, omitted components are treated as zero).
Any non-integer version component or non-integer trailing part of a version
component effectively truncates the string at that point.
</dd>
</dl>
<dl class="simple" id="version-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; VERSION_EQUAL &lt;variable|string&gt;)</code></dt><dd>Component-wise integer version number comparison (version format is
<code class="docutils literal notranslate">major[.minor[.patch[.tweak]]]</code>, omitted components are treated as zero).
Any non-integer version component or non-integer trailing part of a version
component effectively truncates the string at that point.
</dd>
</dl>
<dl id="version-less-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; VERSION_LESS_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: Component-wise integer version number comparison (version format is
<code class="docutils literal notranslate">major[.minor[.patch[.tweak]]]</code>, omitted components are treated as zero).
Any non-integer version component or non-integer trailing part of a version
component effectively truncates the string at that point.
</div>
</dd>
</dl>
<dl id="version-greater-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; VERSION_GREATER_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.7: Component-wise integer version number comparison (version format is
<code class="docutils literal notranslate">major[.minor[.patch[.tweak]]]</code>, omitted components are treated as zero).
Any non-integer version component or non-integer trailing part of a version
component effectively truncates the string at that point.
</div>
</dd>
</dl>
</section>
<section id="path-comparisons">
<h3>Path Comparisons<a class="headerlink" href="#path-comparisons" title="Permalink to this heading">¶</a></h3>
<dl id="path-equal">
<dt><code class="docutils literal notranslate">if(&lt;variable|string&gt; PATH_EQUAL &lt;variable|string&gt;)</code></dt><dd><div class="versionadded">
New in version 3.24.
</div>
Compares the two paths component-by-component. Only if every component of
both paths match will the two paths compare equal. Multiple path separators
are effectively collapsed into a single separator, but note that backslashes
are not converted to forward slashes. No other
<a class="reference internal" href="cmake_path.html#normalization">path normalization</a> is performed.
Component-wise comparison is superior to string-based comparison due to the
handling of multiple path separators. In the following example, the
expression evaluates to true using <code class="docutils literal notranslate">PATH_EQUAL</code>, but false with
<code class="docutils literal notranslate">STREQUAL</code>:
<div class="highlight-cmake notranslate"><div class="highlight"><pre># comparison is TRUE
if (&quot;/a//b/c&quot; PATH_EQUAL &quot;/a/b/c&quot;)
 ...
endif()

# comparison is FALSE
if (&quot;/a//b/c&quot; STREQUAL &quot;/a/b/c&quot;)
 ...
endif()
</pre></div>
</div>
See <a class="reference internal" href="cmake_path.html#path-compare">cmake_path(COMPARE)</a> for more details.
</dd>
</dl>
</section>
</section>
<section id="variable-expansion">
<h2>Variable Expansion<a class="headerlink" href="#variable-expansion" title="Permalink to this heading">¶</a></h2>
The if command was written very early in CMake's history, predating
the <code class="docutils literal notranslate">${}</code> variable evaluation syntax, and for convenience evaluates
variables named by its arguments as shown in the above signatures.
Note that normal variable evaluation with <code class="docutils literal notranslate">${}</code> applies before the if
command even receives the arguments. Therefore code like
<div class="highlight-cmake notranslate"><div class="highlight"><pre>set(var1 OFF)
set(var2 &quot;var1&quot;)
if(${var2})
</pre></div>
</div>
appears to the if command as
<div class="highlight-cmake notranslate"><div class="highlight"><pre>if(var1)
</pre></div>
</div>
and is evaluated according to the <code class="docutils literal notranslate">if(&lt;variable&gt;)</code> case documented
above. The result is <code class="docutils literal notranslate">OFF</code> which is false. However, if we remove the
<code class="docutils literal notranslate">${}</code> from the example then the command sees
<div class="highlight-cmake notranslate"><div class="highlight"><pre>if(var2)
</pre></div>
</div>
which is true because <code class="docutils literal notranslate">var2</code> is defined to <code class="docutils literal notranslate">var1</code> which is not a false
constant.
Automatic evaluation applies in the other cases whenever the
above-documented condition syntax accepts <code class="docutils literal notranslate">&lt;variable|string&gt;</code>:
<ul class="simple">
<li>The left hand argument to <code class="docutils literal notranslate">MATCHES</code> is first checked to see if it is
a defined variable, if so the variable's value is used, otherwise the
original value is used.</li>
<li>If the left hand argument to <code class="docutils literal notranslate">MATCHES</code> is missing it returns false
without error</li>
<li>Both left and right hand arguments to <code class="docutils literal notranslate">LESS</code>, <code class="docutils literal notranslate">GREATER</code>, <code class="docutils literal notranslate">EQUAL</code>,
<code class="docutils literal notranslate">LESS_EQUAL</code>, and <code class="docutils literal notranslate">GREATER_EQUAL</code>, are independently tested to see if
they are defined variables, if so their defined values are used otherwise
the original value is used.</li>
<li>Both left and right hand arguments to <code class="docutils literal notranslate">STRLESS</code>, <code class="docutils literal notranslate">STRGREATER</code>,
<code class="docutils literal notranslate">STREQUAL</code>, <code class="docutils literal notranslate">STRLESS_EQUAL</code>, and <code class="docutils literal notranslate">STRGREATER_EQUAL</code> are independently
tested to see if they are defined variables, if so their defined values are
used otherwise the original value is used.</li>
<li>Both left and right hand arguments to <code class="docutils literal notranslate">VERSION_LESS</code>,
<code class="docutils literal notranslate">VERSION_GREATER</code>, <code class="docutils literal notranslate">VERSION_EQUAL</code>, <code class="docutils literal notranslate">VERSION_LESS_EQUAL</code>, and
<code class="docutils literal notranslate">VERSION_GREATER_EQUAL</code> are independently tested to see if they are defined
variables, if so their defined values are used otherwise the original value
is used.</li>
<li>The right hand argument to <code class="docutils literal notranslate">NOT</code> is tested to see if it is a boolean
constant, if so the value is used, otherwise it is assumed to be a
variable and it is dereferenced.</li>
<li>The left and right hand arguments to <code class="docutils literal notranslate">AND</code> and <code class="docutils literal notranslate">OR</code> are independently
tested to see if they are boolean constants, if so they are used as
such, otherwise they are assumed to be variables and are dereferenced.</li>
</ul>
<div class="versionchanged">
Changed in version 3.1: To prevent ambiguity, potential variable or keyword names can be
specified in a <a class="reference internal" href="../manual/cmake-language.7.html#quoted-argument">Quoted Argument</a> or a <a class="reference internal" href="../manual/cmake-language.7.html#bracket-argument">Bracket Argument</a>.
A quoted or bracketed variable or keyword will be interpreted as a
string and not dereferenced or interpreted.
See policy <a class="reference internal" href="../policy/CMP0054.html#policy:CMP0054" title="CMP0054"><code class="xref cmake cmake-policy docutils literal notranslate">CMP0054</code></a>.
</div>
There is no automatic evaluation for environment or cache
<a class="reference internal" href="../manual/cmake-language.7.html#variable-references">Variable References</a>. Their values must be referenced as
<code class="docutils literal notranslate">$ENV{&lt;name&gt;}</code> or <code class="docutils literal notranslate">$CACHE{&lt;name&gt;}</code> wherever the above-documented
condition syntax accepts <code class="docutils literal notranslate">&lt;variable|string&gt;</code>.
</section>
<section id="see-also">
<h2>See also<a class="headerlink" href="#see-also" title="Permalink to this heading">¶</a></h2>
<ul class="simple">
<li><a class="reference internal" href="else.html#command:else" title="else"><code class="xref cmake cmake-command docutils literal notranslate">else()</code></a></li>
<li><a class="reference internal" href="elseif.html#command:elseif" title="elseif"><code class="xref cmake cmake-command docutils literal notranslate">elseif()</code></a></li>
<li><a class="reference internal" href="endif.html#command:endif" title="endif"><code class="xref cmake cmake-command docutils literal notranslate">endif()</code></a></li>
</ul>
</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="#">if</a><ul>
<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
<li><a class="reference internal" href="#condition-syntax">Condition Syntax</a><ul>
<li><a class="reference internal" href="#basic-expressions">Basic Expressions</a></li>
<li><a class="reference internal" href="#logic-operators">Logic Operators</a></li>
<li><a class="reference internal" href="#existence-checks">Existence Checks</a></li>
<li><a class="reference internal" href="#file-operations">File Operations</a></li>
<li><a class="reference internal" href="#comparisons">Comparisons</a></li>
<li><a class="reference internal" href="#version-comparisons">Version Comparisons</a></li>
<li><a class="reference internal" href="#path-comparisons">Path Comparisons</a></li>
</ul>
</li>
<li><a class="reference internal" href="#variable-expansion">Variable Expansion</a></li>
<li><a class="reference internal" href="#see-also">See also</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="get_property.html"
 title="previous chapter">get_property</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="include.html"
 title="next chapter">include</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/if.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="include.html" title="include"
 >next</a> |</li>
 <li class="right" >
 <a href="get_property.html" title="get_property"
 >previous</a> |</li>
 <li>
 <img src="../_static/cmake-logo-16.png" alt=""
 style="vertical-align: middle; margin-top: -2px" />
 </li>
 <li>
 <a href="https://cmake.org/">CMake</a> &#187;
 </li>
 <li>
 <a href="../index.html">3.26.3 Documentation</a> &#187;
 </li>

<li class="nav-item nav-item-1"><a href="../manual/cmake-commands.7.html" >cmake-commands(7)</a> &#187;</li>
 <li class="nav-item nav-item-this"><a href="">if</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>