Back to Cmake

COMPILE_OPTIONS

Help/prop_sf/COMPILE_OPTIONS.rst

4.3.21.2 KB
Original Source

COMPILE_OPTIONS

.. versionadded:: 3.11

List of additional options to pass to the compiler.

This property holds a :ref:semicolon-separated list <CMake Language Lists> of options and will be added to the list of compile flags when this source file builds. The options will be added after target-wide options.

Contents of COMPILE_OPTIONS may use "generator expressions" with the syntax $<...>. See the :manual:cmake-generator-expressions(7) manual for available expressions. However, :generator:Xcode does not support per-config per-source settings, so expressions that depend on the build configuration are not allowed with that generator.

Usage example:

.. code-block:: cmake

set_source_files_properties(foo.cpp PROPERTIES COMPILE_OPTIONS "-Wno-unused-parameter;-Wno-missing-field-initializer")

Related properties:

  • Prefer this property over :prop_sf:COMPILE_FLAGS.
  • Use :prop_sf:COMPILE_DEFINITIONS to pass additional preprocessor definitions.
  • Use :prop_sf:INCLUDE_DIRECTORIES to pass additional include directories.

Related commands:

  • :command:add_compile_options for directory-wide settings
  • :command:target_compile_options for target-specific settings