cmake/Help/command/add_compile_definitions.rst

34 lines
1.0 KiB
ReStructuredText
Raw Normal View History

2018-08-09 18:06:22 +02:00
add_compile_definitions
-----------------------
2021-09-14 00:13:48 +02:00
.. versionadded:: 3.12
2019-11-11 23:01:05 +01:00
Add preprocessor definitions to the compilation of source files.
2018-08-09 18:06:22 +02:00
2019-11-11 23:01:05 +01:00
.. code-block:: cmake
2018-08-09 18:06:22 +02:00
add_compile_definitions(<definition> ...)
2020-08-30 11:54:41 +02:00
Adds preprocessor definitions to the compiler command line.
The preprocessor definitions are added to the :prop_dir:`COMPILE_DEFINITIONS`
directory property for the current ``CMakeLists`` file. They are also added to
the :prop_tgt:`COMPILE_DEFINITIONS` target property for each target in the
current ``CMakeLists`` file.
2018-08-09 18:06:22 +02:00
Definitions are specified using the syntax ``VAR`` or ``VAR=value``.
Function-style definitions are not supported. CMake will automatically
escape the value correctly for the native build system (note that CMake
language syntax may require escapes to specify some values).
2023-05-23 16:38:00 +02:00
.. versionadded:: 3.26
Any leading ``-D`` on an item will be removed.
.. |command_name| replace:: ``add_compile_definitions``
.. include:: GENEX_NOTE.txt
See Also
^^^^^^^^
* The command :command:`target_compile_definitions` adds target-specific definitions.