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: string.html

<!DOCTYPE html>

<title>string &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="unset.html" title="unset"
 accesskey="N">next</a> |</li>
 <li class="right" >
 <a href="site_name.html" title="site_name"
 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="">string</a></li> 
 </ul>
 </div>

<div class="document">
 <div class="documentwrapper">
 <div class="bodywrapper">
 <div class="body" role="main">
 
 <section id="string">
<h1>string<a class="headerlink" href="#string" title="Permalink to this heading">¶</a></h1>
String operations.
<section id="synopsis">
<h2>Synopsis<a class="headerlink" href="#synopsis" title="Permalink to this heading">¶</a></h2>
<pre class="literal-block"><a class="reference internal" href="#search-and-replace">Search and Replace</a>
 string(<a class="reference internal" href="#find">FIND</a> &lt;string&gt; &lt;substring&gt; &lt;out-var&gt; [...])
 string(<a class="reference internal" href="#replace">REPLACE</a> &lt;match-string&gt; &lt;replace-string&gt; &lt;out-var&gt; &lt;input&gt;...)
 string(<a class="reference internal" href="#regex-match">REGEX MATCH</a> &lt;match-regex&gt; &lt;out-var&gt; &lt;input&gt;...)
 string(<a class="reference internal" href="#regex-matchall">REGEX MATCHALL</a> &lt;match-regex&gt; &lt;out-var&gt; &lt;input&gt;...)
 string(<a class="reference internal" href="#regex-replace">REGEX REPLACE</a> &lt;match-regex&gt; &lt;replace-expr&gt; &lt;out-var&gt; &lt;input&gt;...)

<a class="reference internal" href="#manipulation">Manipulation</a>
 string(<a class="reference internal" href="#append">APPEND</a> &lt;string-var&gt; [&lt;input&gt;...])
 string(<a class="reference internal" href="#prepend">PREPEND</a> &lt;string-var&gt; [&lt;input&gt;...])
 string(<a class="reference internal" href="#concat">CONCAT</a> &lt;out-var&gt; [&lt;input&gt;...])
 string(<a class="reference internal" href="#join">JOIN</a> &lt;glue&gt; &lt;out-var&gt; [&lt;input&gt;...])
 string(<a class="reference internal" href="#tolower">TOLOWER</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#toupper">TOUPPER</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#length">LENGTH</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#substring">SUBSTRING</a> &lt;string&gt; &lt;begin&gt; &lt;length&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#strip">STRIP</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#genex-strip">GENEX_STRIP</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#repeat">REPEAT</a> &lt;string&gt; &lt;count&gt; &lt;out-var&gt;)

<a class="reference internal" href="#comparison">Comparison</a>
 string(<a class="reference internal" href="#compare">COMPARE</a> &lt;op&gt; &lt;string1&gt; &lt;string2&gt; &lt;out-var&gt;)

<a class="reference internal" href="#hashing">Hashing</a>
 string(<a class="reference internal" href="#hash">&lt;HASH&gt;</a> &lt;out-var&gt; &lt;input&gt;)

<a class="reference internal" href="#generation">Generation</a>
 string(<a class="reference internal" href="#ascii">ASCII</a> &lt;number&gt;... &lt;out-var&gt;)
 string(<a class="reference internal" href="#hex">HEX</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#configure">CONFIGURE</a> &lt;string&gt; &lt;out-var&gt; [...])
 string(<a class="reference internal" href="#make-c-identifier">MAKE_C_IDENTIFIER</a> &lt;string&gt; &lt;out-var&gt;)
 string(<a class="reference internal" href="#random">RANDOM</a> [&lt;option&gt;...] &lt;out-var&gt;)
 string(<a class="reference internal" href="#timestamp">TIMESTAMP</a> &lt;out-var&gt; [&lt;format string&gt;] [UTC])
 string(<a class="reference internal" href="#uuid">UUID</a> &lt;out-var&gt; ...)

<a class="reference internal" href="#json">JSON</a>
 string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 {<a class="reference internal" href="#json-get">GET</a> | <a class="reference internal" href="#json-type">TYPE</a> | <a class="reference internal" href="#json-length">LENGTH</a> | <a class="reference internal" href="#json-remove">REMOVE</a>}
 &lt;json-string&gt; &lt;member|index&gt; [&lt;member|index&gt; ...])
 string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 <a class="reference internal" href="#json-member">MEMBER</a> &lt;json-string&gt;
 [&lt;member|index&gt; ...] &lt;index&gt;)
 string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 <a class="reference internal" href="#json-set">SET</a> &lt;json-string&gt;
 &lt;member|index&gt; [&lt;member|index&gt; ...] &lt;value&gt;)
 string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 <a class="reference internal" href="#json-equal">EQUAL</a> &lt;json-string1&gt; &lt;json-string2&gt;)</pre>
</section>
<section id="search-and-replace">
<h2>Search and Replace<a class="headerlink" href="#search-and-replace" title="Permalink to this heading">¶</a></h2>
<section id="search-and-replace-with-plain-strings">
<h3>Search and Replace With Plain Strings<a class="headerlink" href="#search-and-replace-with-plain-strings" title="Permalink to this heading">¶</a></h3>
<div class="highlight-cmake notranslate" id="find"><div class="highlight"><pre>string(FIND &lt;string&gt; &lt;substring&gt; &lt;output_variable&gt; [REVERSE])
</pre></div>
</div>
Return the position where the given <code class="docutils literal notranslate">&lt;substring&gt;</code> was found in
the supplied <code class="docutils literal notranslate">&lt;string&gt;</code>. If the <code class="docutils literal notranslate">REVERSE</code> flag was used, the command will
search for the position of the last occurrence of the specified
<code class="docutils literal notranslate">&lt;substring&gt;</code>. If the <code class="docutils literal notranslate">&lt;substring&gt;</code> is not found, a position of -1 is
returned.
The <code class="docutils literal notranslate">string(FIND)</code> subcommand treats all strings as ASCII-only characters.
The index stored in <code class="docutils literal notranslate">&lt;output_variable&gt;</code> will also be counted in bytes,
so strings containing multi-byte characters may lead to unexpected results.
<div class="highlight-cmake notranslate" id="replace"><div class="highlight"><pre>string(REPLACE &lt;match_string&gt;
 &lt;replace_string&gt; &lt;output_variable&gt;
 &lt;input&gt; [&lt;input&gt;...])
</pre></div>
</div>
Replace all occurrences of <code class="docutils literal notranslate">&lt;match_string&gt;</code> in the <code class="docutils literal notranslate">&lt;input&gt;</code>
with <code class="docutils literal notranslate">&lt;replace_string&gt;</code> and store the result in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
</section>
<section id="search-and-replace-with-regular-expressions">
<h3>Search and Replace With Regular Expressions<a class="headerlink" href="#search-and-replace-with-regular-expressions" title="Permalink to this heading">¶</a></h3>
<div class="highlight-cmake notranslate" id="regex-match"><div class="highlight"><pre>string(REGEX MATCH &lt;regular_expression&gt;
 &lt;output_variable&gt; &lt;input&gt; [&lt;input&gt;...])
</pre></div>
</div>
Match the <code class="docutils literal notranslate">&lt;regular_expression&gt;</code> once and store the match in the
<code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
All <code class="docutils literal notranslate">&lt;input&gt;</code> arguments are concatenated before matching.
Regular expressions are specified in the subsection just below.
<div class="highlight-cmake notranslate" id="regex-matchall"><div class="highlight"><pre>string(REGEX MATCHALL &lt;regular_expression&gt;
 &lt;output_variable&gt; &lt;input&gt; [&lt;input&gt;...])
</pre></div>
</div>
Match the <code class="docutils literal notranslate">&lt;regular_expression&gt;</code> as many times as possible and store the
matches in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code> as a list.
All <code class="docutils literal notranslate">&lt;input&gt;</code> arguments are concatenated before matching.
<div class="highlight-cmake notranslate" id="regex-replace"><div class="highlight"><pre>string(REGEX REPLACE &lt;regular_expression&gt;
 &lt;replacement_expression&gt; &lt;output_variable&gt;
 &lt;input&gt; [&lt;input&gt;...])
</pre></div>
</div>
Match the <code class="docutils literal notranslate">&lt;regular_expression&gt;</code> as many times as possible and substitute
the <code class="docutils literal notranslate">&lt;replacement_expression&gt;</code> for the match in the output.
All <code class="docutils literal notranslate">&lt;input&gt;</code> arguments are concatenated before matching.
The <code class="docutils literal notranslate">&lt;replacement_expression&gt;</code> may refer to parenthesis-delimited
subexpressions of the match using <code class="docutils literal notranslate">\1</code>, <code class="docutils literal notranslate">\2</code>, ..., <code class="docutils literal notranslate">\9</code>. Note that
two backslashes (<code class="docutils literal notranslate">\\1</code>) are required in CMake code to get a backslash
through argument parsing.
</section>
<section id="regex-specification">
<h3>Regex Specification<a class="headerlink" href="#regex-specification" title="Permalink to this heading">¶</a></h3>
The following characters have special meaning in regular expressions:
<dl>
<dt><code class="docutils literal notranslate">^</code></dt><dd>Matches at beginning of input
</dd>
<dt><code class="docutils literal notranslate">$</code></dt><dd>Matches at end of input
</dd>
<dt><code class="docutils literal notranslate">.</code></dt><dd>Matches any single character
</dd>
<dt><code class="docutils literal notranslate">\&lt;char&gt;</code></dt><dd>Matches the single character specified by <code class="docutils literal notranslate">&lt;char&gt;</code>. Use this to
match special regex characters, e.g. <code class="docutils literal notranslate">\.</code> for a literal <code class="docutils literal notranslate">.</code>
or <code class="docutils literal notranslate">\\</code> for a literal backslash <code class="docutils literal notranslate">\</code>. Escaping a non-special
character is unnecessary but allowed, e.g. <code class="docutils literal notranslate">\a</code> matches <code class="docutils literal notranslate">a</code>.
</dd>
<dt><code class="docutils literal notranslate">[ ]</code></dt><dd>Matches any character(s) inside the brackets
</dd>
<dt><code class="docutils literal notranslate">[^ ]</code></dt><dd>Matches any character(s) not inside the brackets
</dd>
<dt><code class="docutils literal notranslate">-</code></dt><dd>Inside brackets, specifies an inclusive range between
characters on either side e.g. <code class="docutils literal notranslate">[a-f]</code> is <code class="docutils literal notranslate">[abcdef]</code>
To match a literal <code class="docutils literal notranslate">-</code> using brackets, make it the first
or the last character e.g. <code class="docutils literal notranslate">[+*/-]</code> matches basic
mathematical operators.
</dd>
<dt><code class="docutils literal notranslate">*</code></dt><dd>Matches preceding pattern zero or more times
</dd>
<dt><code class="docutils literal notranslate">+</code></dt><dd>Matches preceding pattern one or more times
</dd>
<dt><code class="docutils literal notranslate">?</code></dt><dd>Matches preceding pattern zero or once only
</dd>
<dt><code class="docutils literal notranslate">|</code></dt><dd>Matches a pattern on either side of the <code class="docutils literal notranslate">|</code>
</dd>
<dt><code class="docutils literal notranslate">()</code></dt><dd>Saves a matched subexpression, which can be referenced
in the <code class="docutils literal notranslate">REGEX REPLACE</code> operation.
<div class="versionadded">
New in version 3.9: All regular expression-related commands, including e.g.
<a class="reference internal" href="if.html#command:if" title="if"><code class="xref cmake cmake-command docutils literal notranslate">if(MATCHES)</code></a>, save subgroup matches in the variables
<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> for <code class="docutils literal notranslate">&lt;n&gt;</code> 0..9.
</div>
</dd>
</dl>
<code class="docutils literal notranslate">*</code>, <code class="docutils literal notranslate">+</code> and <code class="docutils literal notranslate">?</code> have higher precedence than concatenation. <code class="docutils literal notranslate">|</code>
has lower precedence than concatenation. This means that the regular
expression <code class="docutils literal notranslate">^ab+d$</code> matches <code class="docutils literal notranslate">abbd</code> but not <code class="docutils literal notranslate">ababd</code>, and the regular
expression <code class="docutils literal notranslate">^(ab|cd)$</code> matches <code class="docutils literal notranslate">ab</code> but not <code class="docutils literal notranslate">abd</code>.
CMake language <a class="reference internal" href="../manual/cmake-language.7.html#escape-sequences">Escape Sequences</a> such as <code class="docutils literal notranslate">\t</code>, <code class="docutils literal notranslate">\r</code>, <code class="docutils literal notranslate">\n</code>,
and <code class="docutils literal notranslate">\\</code> may be used to construct literal tabs, carriage returns,
newlines, and backslashes (respectively) to pass in a regex. For example:
<ul class="simple">
<li>The quoted argument <code class="docutils literal notranslate">&quot;[ \t\r\n]&quot;</code> specifies a regex that matches
any single whitespace character.</li>
<li>The quoted argument <code class="docutils literal notranslate">&quot;[/\\]&quot;</code> specifies a regex that matches
a single forward slash <code class="docutils literal notranslate">/</code> or backslash <code class="docutils literal notranslate">\</code>.</li>
<li>The quoted argument <code class="docutils literal notranslate">&quot;[A-Za-z0-9_]&quot;</code> specifies a regex that matches
any single &quot;word&quot; character in the C locale.</li>
<li>The quoted argument <code class="docutils literal notranslate">&quot;\$\\a\\+b\$&quot;</code> specifies a regex that matches
the exact string <code class="docutils literal notranslate">(a+b)</code>. Each <code class="docutils literal notranslate">\\</code> is parsed in a quoted argument
as just <code class="docutils literal notranslate">\</code>, so the regex itself is actually <code class="docutils literal notranslate">$\a\+\b$</code>. This
can alternatively be specified in a <a class="reference internal" href="../manual/cmake-language.7.html#bracket-argument">Bracket Argument</a> without
having to escape the backslashes, e.g. <code class="docutils literal notranslate">[[$\a\+\b$]]</code>.</li>
</ul>
</section>
</section>
<section id="manipulation">
<h2>Manipulation<a class="headerlink" href="#manipulation" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="append"><div class="highlight"><pre>string(APPEND &lt;string_variable&gt; [&lt;input&gt;...])
</pre></div>
</div>
<div class="versionadded">
New in version 3.4.
</div>
Append all the <code class="docutils literal notranslate">&lt;input&gt;</code> arguments to the string.
<div class="highlight-cmake notranslate" id="prepend"><div class="highlight"><pre>string(PREPEND &lt;string_variable&gt; [&lt;input&gt;...])
</pre></div>
</div>
<div class="versionadded">
New in version 3.10.
</div>
Prepend all the <code class="docutils literal notranslate">&lt;input&gt;</code> arguments to the string.
<div class="highlight-cmake notranslate" id="concat"><div class="highlight"><pre>string(CONCAT &lt;output_variable&gt; [&lt;input&gt;...])
</pre></div>
</div>
Concatenate all the <code class="docutils literal notranslate">&lt;input&gt;</code> arguments together and store
the result in the named <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
<div class="highlight-cmake notranslate" id="join"><div class="highlight"><pre>string(JOIN &lt;glue&gt; &lt;output_variable&gt; [&lt;input&gt;...])
</pre></div>
</div>
<div class="versionadded">
New in version 3.12.
</div>
Join all the <code class="docutils literal notranslate">&lt;input&gt;</code> arguments together using the <code class="docutils literal notranslate">&lt;glue&gt;</code>
string and store the result in the named <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
To join a list's elements, prefer to use the <code class="docutils literal notranslate">JOIN</code> operator
from the <a class="reference internal" href="list.html#command:list" title="list"><code class="xref cmake cmake-command docutils literal notranslate">list()</code></a> command. This allows for the elements to have
special characters like <code class="docutils literal notranslate">;</code> in them.
<div class="highlight-cmake notranslate" id="tolower"><div class="highlight"><pre>string(TOLOWER &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Convert <code class="docutils literal notranslate">&lt;string&gt;</code> to lower characters.
<div class="highlight-cmake notranslate" id="toupper"><div class="highlight"><pre>string(TOUPPER &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Convert <code class="docutils literal notranslate">&lt;string&gt;</code> to upper characters.
<div class="highlight-cmake notranslate" id="length"><div class="highlight"><pre>string(LENGTH &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Store in an <code class="docutils literal notranslate">&lt;output_variable&gt;</code> a given string's length in bytes.
Note that this means if <code class="docutils literal notranslate">&lt;string&gt;</code> contains multi-byte characters, the
result stored in <code class="docutils literal notranslate">&lt;output_variable&gt;</code> will not be the number of characters.
<div class="highlight-cmake notranslate" id="substring"><div class="highlight"><pre>string(SUBSTRING &lt;string&gt; &lt;begin&gt; &lt;length&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Store in an <code class="docutils literal notranslate">&lt;output_variable&gt;</code> a substring of a given <code class="docutils literal notranslate">&lt;string&gt;</code>. If
<code class="docutils literal notranslate">&lt;length&gt;</code> is <code class="docutils literal notranslate">-1</code> the remainder of the string starting at <code class="docutils literal notranslate">&lt;begin&gt;</code>
will be returned.
<div class="versionchanged">
Changed in version 3.2: If <code class="docutils literal notranslate">&lt;string&gt;</code> is shorter than <code class="docutils literal notranslate">&lt;length&gt;</code> then the end of the string
is used instead. Previous versions of CMake reported an error in this case.
</div>
Both <code class="docutils literal notranslate">&lt;begin&gt;</code> and <code class="docutils literal notranslate">&lt;length&gt;</code> are counted in bytes, so care must
be exercised if <code class="docutils literal notranslate">&lt;string&gt;</code> could contain multi-byte characters.
<div class="highlight-cmake notranslate" id="strip"><div class="highlight"><pre>string(STRIP &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Store in an <code class="docutils literal notranslate">&lt;output_variable&gt;</code> a substring of a given <code class="docutils literal notranslate">&lt;string&gt;</code> with
leading and trailing spaces removed.
<div class="highlight-cmake notranslate" id="genex-strip"><div class="highlight"><pre>string(GENEX_STRIP &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
<div class="versionadded">
New in version 3.1.
</div>
Strip any <a class="reference internal" href="../manual/cmake-generator-expressions.7.html#manual:cmake-generator-expressions(7)" title="cmake-generator-expressions(7)"><code class="xref cmake cmake-manual docutils literal notranslate">generator expressions</code></a>
from the input <code class="docutils literal notranslate">&lt;string&gt;</code> and store the result in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
<div class="highlight-cmake notranslate" id="repeat"><div class="highlight"><pre>string(REPEAT &lt;string&gt; &lt;count&gt; &lt;output_variable&gt;)
</pre></div>
</div>
<div class="versionadded">
New in version 3.15.
</div>
Produce the output string as the input <code class="docutils literal notranslate">&lt;string&gt;</code> repeated <code class="docutils literal notranslate">&lt;count&gt;</code> times.
</section>
<section id="comparison">
<h2>Comparison<a class="headerlink" href="#comparison" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="compare"><div class="highlight"><pre>string(COMPARE LESS &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
string(COMPARE GREATER &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
string(COMPARE EQUAL &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
string(COMPARE NOTEQUAL &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
string(COMPARE LESS_EQUAL &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
string(COMPARE GREATER_EQUAL &lt;string1&gt; &lt;string2&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Compare the strings and store true or false in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
<div class="versionadded">
New in version 3.7: Added the <code class="docutils literal notranslate">LESS_EQUAL</code> and <code class="docutils literal notranslate">GREATER_EQUAL</code> options.
</div>
</section>
<section id="hashing">
<h2>Hashing<a class="headerlink" href="#hashing" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="hash"><div class="highlight"><pre>string(&lt;HASH&gt; &lt;output_variable&gt; &lt;input&gt;)
</pre></div>
</div>
Compute a cryptographic hash of the <code class="docutils literal notranslate">&lt;input&gt;</code> string.
The supported <code class="docutils literal notranslate">&lt;HASH&gt;</code> algorithm names are:
<dl class="simple">
<dt><code class="docutils literal notranslate">MD5</code></dt><dd>Message-Digest Algorithm 5, RFC 1321.
</dd>
<dt><code class="docutils literal notranslate">SHA1</code></dt><dd>US Secure Hash Algorithm 1, RFC 3174.
</dd>
<dt><code class="docutils literal notranslate">SHA224</code></dt><dd>US Secure Hash Algorithms, RFC 4634.
</dd>
<dt><code class="docutils literal notranslate">SHA256</code></dt><dd>US Secure Hash Algorithms, RFC 4634.
</dd>
<dt><code class="docutils literal notranslate">SHA384</code></dt><dd>US Secure Hash Algorithms, RFC 4634.
</dd>
<dt><code class="docutils literal notranslate">SHA512</code></dt><dd>US Secure Hash Algorithms, RFC 4634.
</dd>
<dt><code class="docutils literal notranslate">SHA3_224</code></dt><dd>Keccak SHA-3.
</dd>
<dt><code class="docutils literal notranslate">SHA3_256</code></dt><dd>Keccak SHA-3.
</dd>
<dt><code class="docutils literal notranslate">SHA3_384</code></dt><dd>Keccak SHA-3.
</dd>
<dt><code class="docutils literal notranslate">SHA3_512</code></dt><dd>Keccak SHA-3.
</dd>
</dl>
<div class="versionadded">
New in version 3.8: Added the <code class="docutils literal notranslate">SHA3_*</code> hash algorithms.
</div>
</section>
<section id="generation">
<h2>Generation<a class="headerlink" href="#generation" title="Permalink to this heading">¶</a></h2>
<div class="highlight-cmake notranslate" id="ascii"><div class="highlight"><pre>string(ASCII &lt;number&gt; [&lt;number&gt; ...] &lt;output_variable&gt;)
</pre></div>
</div>
Convert all numbers into corresponding ASCII characters.
<div class="highlight-cmake notranslate" id="hex"><div class="highlight"><pre>string(HEX &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
<div class="versionadded">
New in version 3.18.
</div>
Convert each byte in the input <code class="docutils literal notranslate">&lt;string&gt;</code> to its hexadecimal representation
and store the concatenated hex digits in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>. Letters in
the output (<code class="docutils literal notranslate">a</code> through <code class="docutils literal notranslate">f</code>) are in lowercase.
<div class="highlight-cmake notranslate" id="configure"><div class="highlight"><pre>string(CONFIGURE &lt;string&gt; &lt;output_variable&gt;
 [@ONLY] [ESCAPE_QUOTES])
</pre></div>
</div>
Transform a <code class="docutils literal notranslate">&lt;string&gt;</code> like <a class="reference internal" href="configure_file.html#command:configure_file" title="configure_file"><code class="xref cmake cmake-command docutils literal notranslate">configure_file()</code></a> transforms a file.
<div class="highlight-cmake notranslate" id="make-c-identifier"><div class="highlight"><pre>string(MAKE_C_IDENTIFIER &lt;string&gt; &lt;output_variable&gt;)
</pre></div>
</div>
Convert each non-alphanumeric character in the input <code class="docutils literal notranslate">&lt;string&gt;</code> to an
underscore and store the result in the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>. If the first
character of the <code class="docutils literal notranslate">&lt;string&gt;</code> is a digit, an underscore will also be prepended
to the result.
<div class="highlight-cmake notranslate" id="random"><div class="highlight"><pre>string(RANDOM [LENGTH &lt;length&gt;] [ALPHABET &lt;alphabet&gt;]
 [RANDOM_SEED &lt;seed&gt;] &lt;output_variable&gt;)
</pre></div>
</div>
Return a random string of given <code class="docutils literal notranslate">&lt;length&gt;</code> consisting of
characters from the given <code class="docutils literal notranslate">&lt;alphabet&gt;</code>. Default length is 5 characters
and default alphabet is all numbers and upper and lower case letters.
If an integer <code class="docutils literal notranslate">RANDOM_SEED</code> is given, its value will be used to seed the
random number generator.
<div class="highlight-cmake notranslate" id="timestamp"><div class="highlight"><pre>string(TIMESTAMP &lt;output_variable&gt; [&lt;format_string&gt;] [UTC])
</pre></div>
</div>
Write a string representation of the current date
and/or time to the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>.
If the command is unable to obtain a timestamp, the <code class="docutils literal notranslate">&lt;output_variable&gt;</code>
will be set to the empty string <code class="docutils literal notranslate">&quot;&quot;</code>.
The optional <code class="docutils literal notranslate">UTC</code> flag requests the current date/time representation to
be in Coordinated Universal Time (UTC) rather than local time.
The optional <code class="docutils literal notranslate">&lt;format_string&gt;</code> may contain the following format
specifiers:
<dl>
<dt><code class="docutils literal notranslate">%%</code></dt><dd><div class="versionadded">
New in version 3.8.
</div>
A literal percent sign (%).
</dd>
<dt><code class="docutils literal notranslate">%d</code></dt><dd>The day of the current month (01-31).
</dd>
<dt><code class="docutils literal notranslate">%H</code></dt><dd>The hour on a 24-hour clock (00-23).
</dd>
<dt><code class="docutils literal notranslate">%I</code></dt><dd>The hour on a 12-hour clock (01-12).
</dd>
<dt><code class="docutils literal notranslate">%j</code></dt><dd>The day of the current year (001-366).
</dd>
<dt><code class="docutils literal notranslate">%m</code></dt><dd>The month of the current year (01-12).
</dd>
<dt><code class="docutils literal notranslate">%b</code></dt><dd><div class="versionadded">
New in version 3.7.
</div>
Abbreviated month name (e.g. Oct).
</dd>
<dt><code class="docutils literal notranslate">%B</code></dt><dd><div class="versionadded">
New in version 3.10.
</div>
Full month name (e.g. October).
</dd>
<dt><code class="docutils literal notranslate">%M</code></dt><dd>The minute of the current hour (00-59).
</dd>
<dt><code class="docutils literal notranslate">%s</code></dt><dd><div class="versionadded">
New in version 3.6.
</div>
Seconds since midnight (UTC) 1-Jan-1970 (UNIX time).
</dd>
<dt><code class="docutils literal notranslate">%S</code></dt><dd>The second of the current minute. 60 represents a leap second. (00-60)
</dd>
<dt><code class="docutils literal notranslate">%f</code></dt><dd><div class="versionadded">
New in version 3.23.
</div>
The microsecond of the current second (000000-999999).
</dd>
<dt><code class="docutils literal notranslate">%U</code></dt><dd>The week number of the current year (00-53).
</dd>
<dt><code class="docutils literal notranslate">%V</code></dt><dd><div class="versionadded">
New in version 3.22.
</div>
The ISO 8601 week number of the current year (01-53).
</dd>
<dt><code class="docutils literal notranslate">%w</code></dt><dd>The day of the current week. 0 is Sunday. (0-6)
</dd>
<dt><code class="docutils literal notranslate">%a</code></dt><dd><div class="versionadded">
New in version 3.7.
</div>
Abbreviated weekday name (e.g. Fri).
</dd>
<dt><code class="docutils literal notranslate">%A</code></dt><dd><div class="versionadded">
New in version 3.10.
</div>
Full weekday name (e.g. Friday).
</dd>
<dt><code class="docutils literal notranslate">%y</code></dt><dd>The last two digits of the current year (00-99).
</dd>
<dt><code class="docutils literal notranslate">%Y</code></dt><dd>The current year.
</dd>
<dt><code class="docutils literal notranslate">%z</code></dt><dd><div class="versionadded">
New in version 3.26.
</div>
The offset of the time zone from UTC, in hours and minutes,
with format <code class="docutils literal notranslate">+hhmm</code> or <code class="docutils literal notranslate">-hhmm</code>.
</dd>
<dt><code class="docutils literal notranslate">%Z</code></dt><dd><div class="versionadded">
New in version 3.26.
</div>
The time zone name.
</dd>
</dl>
Unknown format specifiers will be ignored and copied to the output
as-is.
If no explicit <code class="docutils literal notranslate">&lt;format_string&gt;</code> is given, it will default to:
<div class="highlight-none notranslate"><div class="highlight"><pre>%Y-%m-%dT%H:%M:%S for local time.
%Y-%m-%dT%H:%M:%SZ for UTC.
</pre></div>
</div>
<div class="versionadded">
New in version 3.8: If the <code class="docutils literal notranslate">SOURCE_DATE_EPOCH</code> environment variable is set,
its value will be used instead of the current time.
See <a class="reference external" href="https://reproducible-builds.org/specs/source-date-epoch/">https://reproducible-builds.org/specs/source-date-epoch/</a> for details.
</div>
<div class="highlight-cmake notranslate" id="uuid"><div class="highlight"><pre>string(UUID &lt;output_variable&gt; NAMESPACE &lt;namespace&gt; NAME &lt;name&gt;
 TYPE &lt;MD5|SHA1&gt; [UPPER])
</pre></div>
</div>
<div class="versionadded">
New in version 3.1.
</div>
Create a universally unique identifier (aka GUID) as per RFC4122
based on the hash of the combined values of <code class="docutils literal notranslate">&lt;namespace&gt;</code>
(which itself has to be a valid UUID) and <code class="docutils literal notranslate">&lt;name&gt;</code>.
The hash algorithm can be either <code class="docutils literal notranslate">MD5</code> (Version 3 UUID) or
<code class="docutils literal notranslate">SHA1</code> (Version 5 UUID).
A UUID has the format <code class="docutils literal notranslate">xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</code>
where each <code class="docutils literal notranslate">x</code> represents a lower case hexadecimal character.
Where required, an uppercase representation can be requested
with the optional <code class="docutils literal notranslate">UPPER</code> flag.
</section>
<section id="json">
<h2>JSON<a class="headerlink" href="#json" title="Permalink to this heading">¶</a></h2>
<div class="versionadded">
New in version 3.19.
</div>
Functionality for querying a JSON string.
<div class="admonition note">
Note
In each of the following JSON-related subcommands, if the optional
<code class="docutils literal notranslate">ERROR_VARIABLE</code> argument is given, errors will be reported in
<code class="docutils literal notranslate">&lt;error-variable&gt;</code> and the <code class="docutils literal notranslate">&lt;out-var&gt;</code> will be set to
<code class="docutils literal notranslate">&lt;member|index&gt;-[&lt;member|index&gt;...]-NOTFOUND</code> with the path elements
up to the point where the error occurred, or just <code class="docutils literal notranslate">NOTFOUND</code> if there
is no relevant path. If an error occurs but the <code class="docutils literal notranslate">ERROR_VARIABLE</code>
option is not present, a fatal error message is generated. If no error
occurs, the <code class="docutils literal notranslate">&lt;error-variable&gt;</code> will be set to <code class="docutils literal notranslate">NOTFOUND</code>.
</div>
<div class="highlight-cmake notranslate" id="json-get"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-variable&gt;]
 GET &lt;json-string&gt; &lt;member|index&gt; [&lt;member|index&gt; ...])
</pre></div>
</div>
Get an element from <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location given
by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments.
Array and object elements will be returned as a JSON string.
Boolean elements will be returned as <code class="docutils literal notranslate">ON</code> or <code class="docutils literal notranslate">OFF</code>.
Null elements will be returned as an empty string.
Number and string types will be returned as strings.
<div class="highlight-cmake notranslate" id="json-type"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-variable&gt;]
 TYPE &lt;json-string&gt; &lt;member|index&gt; [&lt;member|index&gt; ...])
</pre></div>
</div>
Get the type of an element in <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location
given by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments. The <code class="docutils literal notranslate">&lt;out-var&gt;</code>
will be set to one of <code class="docutils literal notranslate">NULL</code>, <code class="docutils literal notranslate">NUMBER</code>, <code class="docutils literal notranslate">STRING</code>, <code class="docutils literal notranslate">BOOLEAN</code>,
<code class="docutils literal notranslate">ARRAY</code>, or <code class="docutils literal notranslate">OBJECT</code>.
<div class="highlight-cmake notranslate" id="json-member"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 MEMBER &lt;json-string&gt;
 [&lt;member|index&gt; ...] &lt;index&gt;)
</pre></div>
</div>
Get the name of the <code class="docutils literal notranslate">&lt;index&gt;</code>-th member in <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location
given by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments.
Requires an element of object type.
<div class="highlight-cmake notranslate" id="json-length"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-variable&gt;]
 LENGTH &lt;json-string&gt; [&lt;member|index&gt; ...])
</pre></div>
</div>
Get the length of an element in <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location
given by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments.
Requires an element of array or object type.
<div class="highlight-cmake notranslate" id="json-remove"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-variable&gt;]
 REMOVE &lt;json-string&gt; &lt;member|index&gt; [&lt;member|index&gt; ...])
</pre></div>
</div>
Remove an element from <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location
given by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments. The JSON string
without the removed element will be stored in <code class="docutils literal notranslate">&lt;out-var&gt;</code>.
<div class="highlight-cmake notranslate" id="json-set"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-variable&gt;]
 SET &lt;json-string&gt; &lt;member|index&gt; [&lt;member|index&gt; ...] &lt;value&gt;)
</pre></div>
</div>
Set an element in <code class="docutils literal notranslate">&lt;json-string&gt;</code> at the location
given by the list of <code class="docutils literal notranslate">&lt;member|index&gt;</code> arguments to <code class="docutils literal notranslate">&lt;value&gt;</code>.
The contents of <code class="docutils literal notranslate">&lt;value&gt;</code> should be valid JSON.
<div class="highlight-cmake notranslate" id="json-equal"><div class="highlight"><pre>string(JSON &lt;out-var&gt; [ERROR_VARIABLE &lt;error-var&gt;]
 EQUAL &lt;json-string1&gt; &lt;json-string2&gt;)
</pre></div>
</div>
Compare the two JSON objects given by <code class="docutils literal notranslate">&lt;json-string1&gt;</code> and <code class="docutils literal notranslate">&lt;json-string2&gt;</code>
for equality. The contents of <code class="docutils literal notranslate">&lt;json-string1&gt;</code> and <code class="docutils literal notranslate">&lt;json-string2&gt;</code>
should be valid JSON. The <code class="docutils literal notranslate">&lt;out-var&gt;</code> will be set to a true value if the
JSON objects are considered equal, or a false value otherwise.
</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="#">string</a><ul>
<li><a class="reference internal" href="#synopsis">Synopsis</a></li>
<li><a class="reference internal" href="#search-and-replace">Search and Replace</a><ul>
<li><a class="reference internal" href="#search-and-replace-with-plain-strings">Search and Replace With Plain Strings</a></li>
<li><a class="reference internal" href="#search-and-replace-with-regular-expressions">Search and Replace With Regular Expressions</a></li>
<li><a class="reference internal" href="#regex-specification">Regex Specification</a></li>
</ul>
</li>
<li><a class="reference internal" href="#manipulation">Manipulation</a></li>
<li><a class="reference internal" href="#comparison">Comparison</a></li>
<li><a class="reference internal" href="#hashing">Hashing</a></li>
<li><a class="reference internal" href="#generation">Generation</a></li>
<li><a class="reference internal" href="#json">JSON</a></li>
</ul>
</li>
</ul>

</div>
 <div>
 <h4>Previous topic</h4>
 <a href="site_name.html"
 title="previous chapter">site_name</a>
 </div>
 <div>
 <h4>Next topic</h4>
 <a href="unset.html"
 title="next chapter">unset</a>
 </div>
 <div role="note" aria-label="source link">
 <h3>This Page</h3>
 <ul class="this-page-menu">
 <li><a href="../_sources/command/string.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="unset.html" title="unset"
 >next</a> |</li>
 <li class="right" >
 <a href="site_name.html" title="site_name"
 >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="">string</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>