summaryrefslogtreecommitdiffstats
path: root/Help
diff options
context:
space:
mode:
authorKyle Edwards <kyle.edwards@kitware.com>2020-02-18 15:49:02 (GMT)
committerKyle Edwards <kyle.edwards@kitware.com>2020-02-19 14:11:05 (GMT)
commit5395bf05ebaa122400a2bd9f0b0547cf760aa43c (patch)
tree5ba56ea071815b63403b535f53622dc3f9dde2a4 /Help
parent952945813c091c4267590e80bd8e5421fe64508b (diff)
downloadCMake-5395bf05ebaa122400a2bd9f0b0547cf760aa43c.zip
CMake-5395bf05ebaa122400a2bd9f0b0547cf760aa43c.tar.gz
CMake-5395bf05ebaa122400a2bd9f0b0547cf760aa43c.tar.bz2
string: Add new HEX sub-command
Diffstat (limited to 'Help')
-rw-r--r--Help/command/string.rst11
-rw-r--r--Help/release/dev/string-hex.rst5
2 files changed, 16 insertions, 0 deletions
diff --git a/Help/command/string.rst b/Help/command/string.rst
index ba7c656..cfcf914 100644
--- a/Help/command/string.rst
+++ b/Help/command/string.rst
@@ -36,6 +36,7 @@ Synopsis
`Generation`_
string(`ASCII`_ <number>... <out-var>)
+ string(`HEX`_ <string> <out-var>)
string(`CONFIGURE`_ <string> <out-var> [...])
string(`MAKE_C_IDENTIFIER`_ <string> <out-var>)
string(`RANDOM`_ [<option>...] <out-var>)
@@ -355,6 +356,16 @@ Generation
Convert all numbers into corresponding ASCII characters.
+.. _HEX:
+
+.. code-block:: cmake
+
+ string(HEX <string> <output_variable>)
+
+Convert each byte in the input ``<string>`` to its hexadecimal representation
+and store the concatenated hex digits in the ``<output_variable>``. Letters in
+the output (``a`` through ``f``) are in lowercase.
+
.. _CONFIGURE:
.. code-block:: cmake
diff --git a/Help/release/dev/string-hex.rst b/Help/release/dev/string-hex.rst
new file mode 100644
index 0000000..f220aca
--- /dev/null
+++ b/Help/release/dev/string-hex.rst
@@ -0,0 +1,5 @@
+string-hex
+----------
+
+* The :command:`string` command learned a new ``HEX`` sub-command, which
+ converts strings into their hexadecimal representation.