target_compile_options — CMake 3.20.0 Documentation
source link: https://cmake.org/cmake/help/latest/command/target_compile_options.html
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
target_compile_options¶
Add compile options to a target.
target_compile_options(<target> [BEFORE] <INTERFACE|PUBLIC|PRIVATE> [items1...] [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
Adds options to the COMPILE_OPTIONS
or
INTERFACE_COMPILE_OPTIONS
target properties. These options
are used when compiling the given <target>
, which must have been
created by a command such as add_executable()
or
add_library()
and must not be an ALIAS target.
Arguments¶
If BEFORE
is specified, the content will be prepended to the property
instead of being appended.
The INTERFACE
, PUBLIC
and PRIVATE
keywords are required to
specify the scope of the following arguments. PRIVATE
and PUBLIC
items will populate the COMPILE_OPTIONS
property of
<target>
. PUBLIC
and INTERFACE
items will populate the
INTERFACE_COMPILE_OPTIONS
property of <target>
.
The following arguments specify compile options. Repeated calls for the same
<target>
append items in the order called.
New in version 3.11: Allow setting INTERFACE
items on IMPORTED targets.
Arguments to target_compile_options
may use "generator expressions"
with the syntax $<...>
. See the cmake-generator-expressions(7)
manual for available expressions. See the cmake-buildsystem(7)
manual for more on defining buildsystem properties.
The final set of compile or link options used for a target is constructed by accumulating options from the current target and the usage requirements of its dependencies. The set of options is de-duplicated to avoid repetition.
New in version 3.12: While beneficial for individual options, the de-duplication step can break
up option groups. For example, -D A -D B
becomes -D A B
. One may
specify a group of options using shell-like quoting along with a SHELL:
prefix. The SHELL:
prefix is dropped, and the rest of the option string
is parsed using the separate_arguments()
UNIX_COMMAND
mode.
For example, "SHELL:-D A" "SHELL:-D B"
becomes -D A -D B
.
See Also¶
This command can be used to add any options. However, for adding
preprocessor definitions and include directories it is recommended
to use the more specific commands target_compile_definitions()
and target_include_directories()
.
For directory-wide settings, there is the command add_compile_options()
.
For file-specific settings, there is the source file property COMPILE_OPTIONS
.
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK