Add options to the compilation of source files.
Adds options to the
COMPILE_OPTIONS directory property.
These options are used when compiling targets from the current
directory and below.
add_compile_options may use "generator expressions" with
$<...>. See the
manual for available expressions. See the
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 is dropped, and the rest of the option string
is parsed using the
"SHELL:-D A" "SHELL:-D B" becomes
-D A -D B.
Since different compilers support different options, a typical use of this command is in a compiler-specific conditional clause:
if (MSVC) # warning level 4 and all warnings as errors add_compile_options(/W4 /WX) else() # lots of warnings and all warnings as errors add_compile_options(-Wall -Wextra -pedantic -Werror) endif()
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_options() adds target-specific options.
The source file property
COMPILE_OPTIONS adds options to one