OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	04/04/2023 07:10:48 PM	rwxr-xr-x
📄 add_compile_definitions.rst.txt	1.04 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_compile_options.rst.txt	1.31 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_custom_command.rst.txt	20.78 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_custom_target.rst.txt	7.4 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_definitions.rst.txt	1.38 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_dependencies.rst.txt	1 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_executable.rst.txt	4.3 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_library.rst.txt	11.08 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_link_options.rst.txt	1.08 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_subdirectory.rst.txt	2.06 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 add_test.rst.txt	3.25 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 aux_source_directory.rst.txt	1.06 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 block.rst.txt	1.81 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 break.rst.txt	208 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 build_command.rst.txt	1.86 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 build_name.rst.txt	430 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_host_system_information.rst.txt	11.36 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_language.rst.txt	18.83 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_minimum_required.rst.txt	3.19 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_parse_arguments.rst.txt	4.82 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_path.rst.txt	25.13 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 cmake_policy.rst.txt	5.56 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 configure_file.rst.txt	5.26 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 continue.rst.txt	362 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 create_test_sourcelist.rst.txt	1.52 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_build.rst.txt	3.23 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_configure.rst.txt	1.66 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_coverage.rst.txt	1.62 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_empty_binary_directory.rst.txt	323 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_memcheck.rst.txt	1.49 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_read_custom_files.rst.txt	332 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_run_script.rst.txt	577 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_sleep.rst.txt	265 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_start.rst.txt	3.12 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_submit.rst.txt	4.01 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_test.rst.txt	10.23 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_update.rst.txt	1.34 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 ctest_upload.rst.txt	678 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 define_property.rst.txt	3.3 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 else.rst.txt	129 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 elseif.rst.txt	194 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 enable_language.rst.txt	1.06 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 enable_testing.rst.txt	474 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endblock.rst.txt	190 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endforeach.rst.txt	342 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endfunction.rst.txt	337 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endif.rst.txt	300 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endmacro.rst.txt	319 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 endwhile.rst.txt	317 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 exec_program.rst.txt	958 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 execute_process.rst.txt	6.04 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 export.rst.txt	5.6 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 export_library_dependencies.rst.txt	1.13 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 file.rst.txt	45.8 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 find_file.rst.txt	1.55 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 find_library.rst.txt	3.85 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 find_package.rst.txt	32.47 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 find_path.rst.txt	1.84 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 find_program.rst.txt	1.44 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 fltk_wrap_ui.rst.txt	380 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 foreach.rst.txt	3.57 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 function.rst.txt	2.32 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_cmake_property.rst.txt	766 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_directory_property.rst.txt	1.28 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_filename_component.rst.txt	2.54 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_property.rst.txt	3.46 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_source_file_property.rst.txt	1.96 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_target_property.rst.txt	1.15 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 get_test_property.rst.txt	831 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 if.rst.txt	14.6 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 include.rst.txt	1.06 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 include_directories.rst.txt	1.57 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 include_external_msproject.rst.txt	1.09 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 include_guard.rst.txt	1.8 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 include_regular_expression.rst.txt	571 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 install.rst.txt	43.13 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 install_files.rst.txt	1.39 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 install_programs.rst.txt	1.26 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 install_targets.rst.txt	664 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 link_directories.rst.txt	2.53 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 link_libraries.rst.txt	669 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 list.rst.txt	10.1 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 load_cache.rst.txt	1001 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 load_command.rst.txt	686 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 macro.rst.txt	4.77 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 make_directory.rst.txt	306 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 mark_as_advanced.rst.txt	867 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 math.rst.txt	1.19 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 message.rst.txt	8.12 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 option.rst.txt	615 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 output_required_files.rst.txt	680 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 project.rst.txt	6.16 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 qt_wrap_cpp.rst.txt	829 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 qt_wrap_ui.rst.txt	981 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 remove.rst.txt	306 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 remove_definitions.rst.txt	293 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 return.rst.txt	3.21 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 separate_arguments.rst.txt	2.53 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 set.rst.txt	4.39 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 set_directory_properties.rst.txt	630 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 set_property.rst.txt	4.38 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 set_source_files_properties.rst.txt	1.68 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 set_target_properties.rst.txt	758 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 set_tests_properties.rst.txt	624 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 site_name.rst.txt	304 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 source_group.rst.txt	2.18 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 string.rst.txt	18.51 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 subdir_depends.rst.txt	306 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 subdirs.rst.txt	1.05 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_compile_definitions.rst.txt	2.15 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_compile_features.rst.txt	1.82 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_compile_options.rst.txt	2.13 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_include_directories.rst.txt	3.57 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_link_directories.rst.txt	2.77 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_link_libraries.rst.txt	16.66 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_link_options.rst.txt	2.14 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_precompile_headers.rst.txt	5.6 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 target_sources.rst.txt	7.99 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 try_compile.rst.txt	13.25 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 try_run.rst.txt	5.71 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 unset.rst.txt	1.54 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 use_mangled_mesa.rst.txt	475 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 utility_source.rst.txt	977 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 variable_requires.rst.txt	784 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 variable_watch.rst.txt	1.76 KB	04/04/2023 07:03:28 PM	rw-r--r--
📄 while.rst.txt	891 bytes	04/04/2023 07:03:28 PM	rw-r--r--
📄 write_file.rst.txt	705 bytes	04/04/2023 07:03:28 PM	rw-r--r--

Editing: list.rst.txt

list
----

List operations.

Synopsis
^^^^^^^^

.. parsed-literal::

`Reading`_
    list(`LENGTH`_ <list> <out-var>)
    list(`GET`_ <list> <element index> [<index> ...] <out-var>)
    list(`JOIN`_ <list> <glue> <out-var>)
    list(`SUBLIST`_ <list> <begin> <length> <out-var>)

`Search`_
    list(`FIND`_ <list> <value> <out-var>)

`Modification`_
    list(`APPEND`_ <list> [<element>...])
    list(`FILTER`_ <list> {INCLUDE | EXCLUDE} REGEX <regex>)
    list(`INSERT`_ <list> <index> [<element>...])
    list(`POP_BACK`_ <list> [<out-var>...])
    list(`POP_FRONT`_ <list> [<out-var>...])
    list(`PREPEND`_ <list> [<element>...])
    list(`REMOVE_ITEM`_ <list> <value>...)
    list(`REMOVE_AT`_ <list> <index>...)
    list(`REMOVE_DUPLICATES`_ <list>)
    list(`TRANSFORM`_ <list> <ACTION> [...])

`Ordering`_
    list(`REVERSE`_ <list>)
    list(`SORT`_ <list> [...])

Introduction
^^^^^^^^^^^^

The list subcommands ``APPEND``, ``INSERT``, ``FILTER``, ``PREPEND``,
``POP_BACK``, ``POP_FRONT``, ``REMOVE_AT``, ``REMOVE_ITEM``,
``REMOVE_DUPLICATES``, ``REVERSE`` and ``SORT`` may create
new values for the list within the current CMake variable scope.  Similar to
the :command:`set` command, the LIST command creates new variable values in
the current scope, even if the list itself is actually defined in a parent
scope.  To propagate the results of these operations upwards, use
:command:`set` with ``PARENT_SCOPE``, :command:`set` with
``CACHE INTERNAL``, or some other means of value propagation.

.. note::

A list in cmake is a ``;`` separated group of strings.  To create a
  list the set command can be used.  For example, ``set(var a b c d e)``
  creates a list with ``a;b;c;d;e``, and ``set(var "a b c d e")`` creates a
  string or a list with one item in it.   (Note macro arguments are not
  variables, and therefore cannot be used in LIST commands.)

.. note::

When specifying index values, if ``<element index>`` is 0 or greater, it
  is indexed from the beginning of the list, with 0 representing the
  first list element.  If ``<element index>`` is -1 or lesser, it is indexed
  from the end of the list, with -1 representing the last list element.
  Be careful when counting with negative indices: they do not start from
  0.  -0 is equivalent to 0, the first list element.

Reading
^^^^^^^

.. _LENGTH:

.. code-block:: cmake

list(LENGTH <list> <output variable>)

Returns the list's length.

.. _GET:

.. code-block:: cmake

list(GET <list> <element index> [<element index> ...] <output variable>)

Returns the list of elements specified by indices from the list.

.. _JOIN:

.. code-block:: cmake

list(JOIN <list> <glue> <output variable>)

.. versionadded:: 3.12

Returns a string joining all list's elements using the glue string.
To join multiple strings, which are not part of a list, use ``JOIN`` operator
from :command:`string` command.

.. _SUBLIST:

.. code-block:: cmake

list(SUBLIST <list> <begin> <length> <output variable>)

.. versionadded:: 3.12

Returns a sublist of the given list.
If ``<length>`` is 0, an empty list will be returned.
If ``<length>`` is -1 or the list is smaller than ``<begin>+<length>`` then
the remaining elements of the list starting at ``<begin>`` will be returned.

Search
^^^^^^

.. _FIND:

.. code-block:: cmake

list(FIND <list> <value> <output variable>)

Returns the index of the element specified in the list or -1
if it wasn't found.

Modification
^^^^^^^^^^^^

.. _APPEND:

.. code-block:: cmake

list(APPEND <list> [<element> ...])

Appends elements to the list. If no variable named ``<list>`` exists in the
current scope its value is treated as empty and the elements are appended to
that empty list.

.. _FILTER:

.. code-block:: cmake

list(FILTER <list> <INCLUDE|EXCLUDE> REGEX <regular_expression>)

.. versionadded:: 3.6

Includes or removes items from the list that match the mode's pattern.
In ``REGEX`` mode, items will be matched against the given regular expression.

For more information on regular expressions look under
:ref:`string(REGEX) <Regex Specification>`.

.. _INSERT:

.. code-block:: cmake

list(INSERT <list> <element_index> <element> [<element> ...])

Inserts elements to the list to the specified index. It is an
error to specify an out-of-range index. Valid indexes are 0 to `N`
where `N` is the length of the list, inclusive. An empty list
has length 0. If no variable named ``<list>`` exists in the
current scope its value is treated as empty and the elements are
inserted in that empty list.

.. _POP_BACK:

.. code-block:: cmake

list(POP_BACK <list> [<out-var>...])

.. versionadded:: 3.15

If no variable name is given, removes exactly one element. Otherwise,
with `N` variable names provided, assign the last `N` elements' values
to the given variables and then remove the last `N` values from
``<list>``.

.. _POP_FRONT:

.. code-block:: cmake

list(POP_FRONT <list> [<out-var>...])

.. versionadded:: 3.15

If no variable name is given, removes exactly one element. Otherwise,
with `N` variable names provided, assign the first `N` elements' values
to the given variables and then remove the first `N` values from
``<list>``.

.. _PREPEND:

.. code-block:: cmake

list(PREPEND <list> [<element> ...])

.. versionadded:: 3.15

Insert elements to the 0th position in the list. If no variable named
``<list>`` exists in the current scope its value is treated as empty and
the elements are prepended to that empty list.

.. _REMOVE_ITEM:

.. code-block:: cmake

list(REMOVE_ITEM <list> <value> [<value> ...])

Removes all instances of the given items from the list.

.. _REMOVE_AT:

.. code-block:: cmake

list(REMOVE_AT <list> <index> [<index> ...])

Removes items at given indices from the list.

.. _REMOVE_DUPLICATES:

.. code-block:: cmake

list(REMOVE_DUPLICATES <list>)

Removes duplicated items in the list. The relative order of items is preserved,
but if duplicates are encountered, only the first instance is preserved.

.. _TRANSFORM:

.. code-block:: cmake

list(TRANSFORM <list> <ACTION> [<SELECTOR>]
                        [OUTPUT_VARIABLE <output variable>])

.. versionadded:: 3.12

Transforms the list by applying an action to all or, by specifying a
``<SELECTOR>``, to the selected elements of the list, storing the result
in-place or in the specified output variable.

.. note::

The ``TRANSFORM`` sub-command does not change the number of elements in the
   list. If a ``<SELECTOR>`` is specified, only some elements will be changed,
   the other ones will remain the same as before the transformation.

``<ACTION>`` specifies the action to apply to the elements of the list.
The actions have exactly the same semantics as sub-commands of the
:command:`string` command.  ``<ACTION>`` must be one of the following:

``APPEND``, ``PREPEND``: Append, prepend specified value to each element of
the list.

.. code-block:: cmake

list(TRANSFORM <list> <APPEND|PREPEND> <value> ...)

``TOUPPER``, ``TOLOWER``: Convert each element of the list to upper, lower
characters.

.. code-block:: cmake

list(TRANSFORM <list> <TOLOWER|TOUPPER> ...)

``STRIP``: Remove leading and trailing spaces from each element of the
list.

.. code-block:: cmake

list(TRANSFORM <list> STRIP ...)

``GENEX_STRIP``: Strip any
:manual:`generator expressions <cmake-generator-expressions(7)>` from each
element of the list.

.. code-block:: cmake

list(TRANSFORM <list> GENEX_STRIP ...)

``REPLACE``: Match the regular expression as many times as possible and
substitute the replacement expression for the match for each element
of the list
(Same semantic as ``REGEX REPLACE`` from :command:`string` command).

.. code-block:: cmake

list(TRANSFORM <list> REPLACE <regular_expression>
                                  <replace_expression> ...)

``<SELECTOR>`` determines which elements of the list will be transformed.
Only one type of selector can be specified at a time.  When given,
``<SELECTOR>`` must be one of the following:

``AT``: Specify a list of indexes.

.. code-block:: cmake

list(TRANSFORM <list> <ACTION> AT <index> [<index> ...] ...)

``FOR``: Specify a range with, optionally, an increment used to iterate over
the range.

.. code-block:: cmake

list(TRANSFORM <list> <ACTION> FOR <start> <stop> [<step>] ...)

``REGEX``: Specify a regular expression. Only elements matching the regular
expression will be transformed.

.. code-block:: cmake

list(TRANSFORM <list> <ACTION> REGEX <regular_expression> ...)

Ordering
^^^^^^^^

.. _REVERSE:

.. code-block:: cmake

list(REVERSE <list>)

Reverses the contents of the list in-place.

.. _SORT:

.. code-block:: cmake

list(SORT <list> [COMPARE <compare>] [CASE <case>] [ORDER <order>])

Sorts the list in-place alphabetically.

.. versionadded:: 3.13
  Added the ``COMPARE``, ``CASE``, and ``ORDER`` options.

.. versionadded:: 3.18
  Added the ``COMPARE NATURAL`` option.

Use the ``COMPARE`` keyword to select the comparison method for sorting.
The ``<compare>`` option should be one of:

* ``STRING``: Sorts a list of strings alphabetically.  This is the
  default behavior if the ``COMPARE`` option is not given.
* ``FILE_BASENAME``: Sorts a list of pathnames of files by their basenames.
* ``NATURAL``: Sorts a list of strings using natural order
  (see ``strverscmp(3)`` manual), i.e. such that contiguous digits
  are compared as whole numbers.
  For example: the following list `10.0 1.1 2.1 8.0 2.0 3.1`
  will be sorted as `1.1 2.0 2.1 3.1 8.0 10.0` if the ``NATURAL``
  comparison is selected where it will be sorted as
  `1.1 10.0 2.0 2.1 3.1 8.0` with the ``STRING`` comparison.

Use the ``CASE`` keyword to select a case sensitive or case insensitive
sort mode.  The ``<case>`` option should be one of:

* ``SENSITIVE``: List items are sorted in a case-sensitive manner.  This is
  the default behavior if the ``CASE`` option is not given.
* ``INSENSITIVE``: List items are sorted case insensitively.  The order of
  items which differ only by upper/lowercase is not specified.

To control the sort order, the ``ORDER`` keyword can be given.
The ``<order>`` option should be one of:

* ``ASCENDING``: Sorts the list in ascending order.  This is the default
  behavior when the ``ORDER`` option is not given.
* ``DESCENDING``: Sorts the list in descending order.