summaryrefslogtreecommitdiffstats
path: root/Help/command/load_command.rst
blob: 4b3888ffcdb4f29cb4222e17d36c5f97a1626d19 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
load_command
------------

Disallowed since version 3.0.  See CMake Policy :policy:`CMP0031`.

Load a command into a running CMake.

.. code-block:: cmake

  load_command(COMMAND_NAME <loc1> [loc2 ...])

The given locations are searched for a library whose name is
cmCOMMAND_NAME.  If found, it is loaded as a module and the command is
added to the set of available CMake commands.  Usually,
:command:`try_compile` is used before this command to compile the
module.  If the command is successfully loaded a variable named

.. code-block:: cmake

  CMAKE_LOADED_COMMAND_<COMMAND_NAME>

will be set to the full path of the module that was loaded.  Otherwise
the variable will not be set.