byp4a55 professor6T9

Linux ded7073.inmotionhosting.com 4.18.0-553.72.1.el8_10.x86_64 #1 SMP Tue Sep 2 06:07:48 EDT 2025 x86_64
Apache
209.182.213.109

File Name : target_precompile_headers.rst

target_precompile_headers
-------------------------

.. versionadded:: 3.16

Add a list of header files to precompile.

Precompiling header files can speed up compilation by creating a partially
processed version of some header files, and then using that version during
compilations rather than repeatedly parsing the original headers.

Main Form
^^^^^^^^^

.. code-block:: cmake

target_precompile_headers(<target>
    <INTERFACE|PUBLIC|PRIVATE> [header1...]
    [<INTERFACE|PUBLIC|PRIVATE> [header2...] ...])

The command adds header files to the :prop_tgt:`PRECOMPILE_HEADERS` and/or
:prop_tgt:`INTERFACE_PRECOMPILE_HEADERS` target properties of ``<target>``.
The named ``<target>`` must have been created by a command such as
:command:`add_executable` or :command:`add_library` and must not be an
:ref:`ALIAS target <Alias Targets>`.

The ``INTERFACE``, ``PUBLIC`` and ``PRIVATE`` keywords are required to
specify the :ref:`scope <Target Usage Requirements>` of the following arguments.
``PRIVATE`` and ``PUBLIC`` items will populate the :prop_tgt:`PRECOMPILE_HEADERS`
property of ``<target>``.  ``PUBLIC`` and ``INTERFACE`` items will populate the
:prop_tgt:`INTERFACE_PRECOMPILE_HEADERS` property of ``<target>``
(:ref:`IMPORTED targets <Imported Targets>` only support ``INTERFACE`` items).
Repeated calls for the same ``<target>`` will append items in the order called.

Projects should generally avoid using ``PUBLIC`` or ``INTERFACE`` for targets
that will be :ref:`exported <install(EXPORT)>`, or they should at least use
the :genex:`$<BUILD_INTERFACE:...>` generator expression to prevent precompile
headers from appearing in an installed exported target.  Consumers of a target
should typically be in control of what precompile headers they use, not have
precompile headers forced on them by the targets being consumed (since
precompile headers are not typically usage requirements).  A notable exception
to this is where an :ref:`interface library <Interface Libraries>` is created
to define a commonly used set of precompile headers in one place and then other
targets link to that interface library privately.  In this case, the interface
library exists specifically to propagate the precompile headers to its
consumers and the consumer is effectively still in control, since it decides
whether to link to the interface library or not.

The list of header files is used to generate a header file named
``cmake_pch.h|xx`` which is used to generate the precompiled header file
(``.pch``, ``.gch``, ``.pchi``) artifact.  The ``cmake_pch.h|xx`` header
file will be force included (``-include`` for GCC, ``/FI`` for MSVC) to
all source files, so sources do not need to have ``#include "pch.h"``.

Header file names specified with angle brackets (e.g. ``<unordered_map>``) or
explicit double quotes (escaped for the :manual:`cmake-language(7)`,
e.g. ``[["other_header.h"]]``) will be treated as is, and include directories
must be available for the compiler to find them.  Other header file names
(e.g. ``project_header.h``) are interpreted as being relative to the current
source directory (e.g. :variable:`CMAKE_CURRENT_SOURCE_DIR`) and will be
included by absolute path.  For example:

.. code-block:: cmake

target_precompile_headers(myTarget
    PUBLIC
      project_header.h
    PRIVATE
      [["other_header.h"]]
      <unordered_map>
  )

.. |command_name| replace:: ``target_compile_features``
.. |more_see_also| replace:: The :genex:`$<COMPILE_LANGUAGE:...>` generator
   expression is particularly useful for specifying a language-specific header
   to precompile for only one language (e.g. ``CXX`` and not ``C``).  In this
   case, header file names that are not explicitly in double quotes or angle
   brackets must be specified by absolute path.  Also, when specifying angle
   brackets inside a generator expression, be sure to encode the closing
   ``>`` as :genex:`$<ANGLE-R>`.  For example:
.. include:: GENEX_NOTE.txt
   :start-line: 1

.. code-block:: cmake

target_precompile_headers(mylib PRIVATE
    "$<$<COMPILE_LANGUAGE:CXX>:${CMAKE_CURRENT_SOURCE_DIR}/cxx_only.h>"
    "$<$<COMPILE_LANGUAGE:C>:<stddef.h$<ANGLE-R>>"
    "$<$<COMPILE_LANGUAGE:CXX>:<cstddef$<ANGLE-R>>"
  )

Reusing Precompile Headers
^^^^^^^^^^^^^^^^^^^^^^^^^^

The command also supports a second signature which can be used to specify that
one target re-uses a precompiled header file artifact from another target
instead of generating its own:

.. code-block:: cmake

target_precompile_headers(<target> REUSE_FROM <other_target>)

This form sets the :prop_tgt:`PRECOMPILE_HEADERS_REUSE_FROM` property to
``<other_target>`` and adds a dependency such that ``<target>`` will depend
on ``<other_target>``.  CMake will halt with an error if the
:prop_tgt:`PRECOMPILE_HEADERS` property of ``<target>`` is already set when
the ``REUSE_FROM`` form is used.

.. note::

The ``REUSE_FROM`` form requires the same set of compiler options,
  compiler flags and compiler definitions for both ``<target>`` and
  ``<other_target>``.  Some compilers (e.g. GCC) may issue a warning if the
  precompiled header file cannot be used (``-Winvalid-pch``).

See Also
^^^^^^^^

* To disable precompile headers for specific targets, see the
  :prop_tgt:`DISABLE_PRECOMPILE_HEADERS` target property.

* To prevent precompile headers from being used when compiling a specific
  source file, see the :prop_sf:`SKIP_PRECOMPILE_HEADERS` source file property.

* :command:`target_compile_definitions`
* :command:`target_compile_features`
* :command:`target_compile_options`
* :command:`target_include_directories`
* :command:`target_link_libraries`
* :command:`target_link_directories`
* :command:`target_link_options`
* :command:`target_sources`

Name	Type	Size	Owner/Group	Permission	Last Modified	Actions
.	dir	-	root/root	0755	2025-03-11 03:11:53
..	dir	-	root/root	0755	2025-03-11 03:11:53
DEVICE_LINK_OPTIONS.txt	text/plain	651 B	root/root	0644	2023-07-19 05:56:04
FIND_XXX.txt	text/plain	8.56 KB	root/root	0644	2023-07-19 05:56:04
FIND_XXX_ORDER.txt	text/plain	446 B	root/root	0644	2023-07-19 05:56:04
FIND_XXX_REGISTRY_VIEW.txt	text/plain	1.31 KB	root/root	0644	2023-07-19 05:56:04
FIND_XXX_ROOT.txt	text/plain	1.41 KB	root/root	0644	2023-07-19 05:56:04
GENEX_NOTE.txt	text/plain	310 B	root/root	0644	2023-07-19 05:56:04
LINK_OPTIONS_LINKER.txt	text/plain	1.07 KB	root/root	0644	2023-07-19 05:56:04
OPTIONS_SHELL.txt	text/plain	772 B	root/root	0644	2023-07-19 05:56:04
SUPPORTED_LANGUAGES.txt	text/plain	753 B	root/root	0644	2023-07-19 05:56:04
add_compile_definitions.rst	text/plain	1.04 KB	root/root	0644	2023-07-19 05:56:04
add_compile_options.rst	text/plain	1.31 KB	root/root	0644	2023-07-19 05:56:04
add_custom_command.rst	text/plain	20.78 KB	root/root	0644	2023-07-19 05:56:04
add_custom_target.rst	text/plain	7.4 KB	root/root	0644	2023-07-19 05:56:04
add_definitions.rst	text/plain	1.38 KB	root/root	0644	2023-07-19 05:56:04
add_dependencies.rst	text/plain	1 KB	root/root	0644	2023-07-19 05:56:04
add_executable.rst	text/plain	4.3 KB	root/root	0644	2023-07-19 05:56:04
add_library.rst	text/plain	11.08 KB	root/root	0644	2023-07-19 05:56:04
add_link_options.rst	text/plain	1.08 KB	root/root	0644	2023-07-19 05:56:04
add_subdirectory.rst	text/plain	2.06 KB	root/root	0644	2023-07-19 05:56:04
add_test.rst	text/plain	3.25 KB	root/root	0644	2023-07-19 05:56:04
aux_source_directory.rst	text/plain	1.06 KB	root/root	0644	2023-07-19 05:56:04
block.rst	text/plain	1.81 KB	root/root	0644	2023-07-19 05:56:04
break.rst	text/plain	208 B	root/root	0644	2023-07-19 05:56:04
build_command.rst	text/plain	1.86 KB	root/root	0644	2023-07-19 05:56:04
build_name.rst	text/plain	430 B	root/root	0644	2023-07-19 05:56:04
cmake_host_system_information.rst	text/plain	11.36 KB	root/root	0644	2023-07-19 05:56:04
cmake_language.rst	text/plain	18.83 KB	root/root	0644	2023-07-19 05:56:04
cmake_minimum_required.rst	text/plain	3.19 KB	root/root	0644	2023-07-19 05:56:04
cmake_parse_arguments.rst	text/plain	4.82 KB	root/root	0644	2023-07-19 05:56:04
cmake_path.rst	text/plain	25.13 KB	root/root	0644	2023-07-19 05:56:04
cmake_policy.rst	text/plain	5.56 KB	root/root	0644	2023-07-19 05:56:04
configure_file.rst	text/html	5.26 KB	root/root	0644	2023-07-19 05:56:04
continue.rst	text/plain	362 B	root/root	0644	2023-07-19 05:56:04
create_test_sourcelist.rst	text/plain	1.52 KB	root/root	0644	2023-07-19 05:56:04
ctest_build.rst	text/plain	3.23 KB	root/root	0644	2023-07-19 05:56:04
ctest_configure.rst	text/plain	1.66 KB	root/root	0644	2023-07-19 05:56:04
ctest_coverage.rst	text/plain	1.62 KB	root/root	0644	2023-07-19 05:56:04
ctest_empty_binary_directory.rst	text/plain	323 B	root/root	0644	2023-07-19 05:56:04
ctest_memcheck.rst	text/plain	1.49 KB	root/root	0644	2023-07-19 05:56:04
ctest_read_custom_files.rst	text/plain	332 B	root/root	0644	2023-07-19 05:56:04
ctest_run_script.rst	text/plain	577 B	root/root	0644	2023-07-19 05:56:04
ctest_sleep.rst	text/plain	265 B	root/root	0644	2023-07-19 05:56:04
ctest_start.rst	text/plain	3.12 KB	root/root	0644	2023-07-19 05:56:04
ctest_submit.rst	text/plain	4.01 KB	root/root	0644	2023-07-19 05:56:04
ctest_test.rst	text/plain	10.23 KB	root/root	0644	2023-07-19 05:56:04
ctest_update.rst	text/plain	1.34 KB	root/root	0644	2023-07-19 05:56:04
ctest_upload.rst	text/plain	678 B	root/root	0644	2023-07-19 05:56:04
define_property.rst	text/plain	3.3 KB	root/root	0644	2023-07-19 05:56:04
else.rst	text/plain	129 B	root/root	0644	2023-07-19 05:56:04
elseif.rst	text/plain	194 B	root/root	0644	2023-07-19 05:56:04
enable_language.rst	text/plain	894 B	root/root	0644	2023-07-19 05:56:04
enable_testing.rst	text/plain	474 B	root/root	0644	2023-07-19 05:56:04
endblock.rst	text/plain	190 B	root/root	0644	2023-07-19 05:56:04
endforeach.rst	text/plain	342 B	root/root	0644	2023-07-19 05:56:04
endfunction.rst	text/plain	337 B	root/root	0644	2023-07-19 05:56:04
endif.rst	text/plain	300 B	root/root	0644	2023-07-19 05:56:04
endmacro.rst	text/plain	319 B	root/root	0644	2023-07-19 05:56:04
endwhile.rst	text/plain	317 B	root/root	0644	2023-07-19 05:56:04
exec_program.rst	text/plain	958 B	root/root	0644	2023-07-19 05:56:04
execute_process.rst	text/plain	6.04 KB	root/root	0644	2023-07-19 05:56:04
export.rst	text/plain	5.6 KB	root/root	0644	2023-07-19 05:56:04
export_library_dependencies.rst	text/plain	1.13 KB	root/root	0644	2023-07-19 05:56:04
file.rst	text/plain	45.8 KB	root/root	0644	2023-07-19 05:56:04
find_file.rst	text/plain	1.55 KB	root/root	0644	2023-07-19 05:56:04
find_library.rst	text/plain	3.85 KB	root/root	0644	2023-07-19 05:56:04
find_package.rst	text/plain	32.47 KB	root/root	0644	2023-07-19 05:56:04
find_path.rst	text/plain	1.84 KB	root/root	0644	2023-07-19 05:56:04
find_program.rst	text/plain	1.44 KB	root/root	0644	2023-07-19 05:56:04
fltk_wrap_ui.rst	text/plain	380 B	root/root	0644	2023-07-19 05:56:04
foreach.rst	text/plain	3.57 KB	root/root	0644	2023-07-19 05:56:04
function.rst	text/plain	2.32 KB	root/root	0644	2023-07-19 05:56:04
get_cmake_property.rst	text/plain	766 B	root/root	0644	2023-07-19 05:56:04
get_directory_property.rst	text/plain	1.28 KB	root/root	0644	2023-07-19 05:56:04
get_filename_component.rst	text/plain	2.54 KB	root/root	0644	2023-07-19 05:56:04
get_property.rst	text/plain	3.46 KB	root/root	0644	2023-07-19 05:56:04
get_source_file_property.rst	text/plain	1.96 KB	root/root	0644	2023-07-19 05:56:04
get_target_property.rst	text/plain	1.15 KB	root/root	0644	2023-07-19 05:56:04
get_test_property.rst	text/plain	831 B	root/root	0644	2023-07-19 05:56:04
if.rst	text/plain	14.6 KB	root/root	0644	2023-07-19 05:56:04
include.rst	text/plain	1.06 KB	root/root	0644	2023-07-19 05:56:04
include_directories.rst	text/plain	1.57 KB	root/root	0644	2023-07-19 05:56:04
include_external_msproject.rst	text/plain	1.09 KB	root/root	0644	2023-07-19 05:56:04
include_guard.rst	text/plain	1.8 KB	root/root	0644	2023-07-19 05:56:04
include_regular_expression.rst	text/plain	571 B	root/root	0644	2023-07-19 05:56:04
install.rst	text/plain	43.13 KB	root/root	0644	2023-07-19 05:56:04
install_files.rst	text/plain	1.39 KB	root/root	0644	2023-07-19 05:56:04
install_programs.rst	text/plain	1.26 KB	root/root	0644	2023-07-19 05:56:04
install_targets.rst	text/plain	664 B	root/root	0644	2023-07-19 05:56:04
link_directories.rst	text/plain	2.53 KB	root/root	0644	2023-07-19 05:56:04
link_libraries.rst	text/plain	669 B	root/root	0644	2023-07-19 05:56:04
list.rst	text/plain	10.1 KB	root/root	0644	2023-07-19 05:56:04
load_cache.rst	text/plain	1001 B	root/root	0644	2023-07-19 05:56:04
load_command.rst	text/plain	686 B	root/root	0644	2023-07-19 05:56:04
macro.rst	text/plain	4.77 KB	root/root	0644	2023-07-19 05:56:04
make_directory.rst	text/plain	306 B	root/root	0644	2023-07-19 05:56:04
mark_as_advanced.rst	text/plain	867 B	root/root	0644	2023-07-19 05:56:04
math.rst	text/plain	1.19 KB	root/root	0644	2023-07-19 05:56:04
message.rst	text/plain	8.12 KB	root/root	0644	2023-07-19 05:56:04
option.rst	text/plain	615 B	root/root	0644	2023-07-19 05:56:04
output_required_files.rst	text/plain	680 B	root/root	0644	2023-07-19 05:56:04
project.rst	text/plain	6.34 KB	root/root	0644	2023-07-19 05:56:04
qt_wrap_cpp.rst	text/plain	829 B	root/root	0644	2023-07-19 05:56:04
qt_wrap_ui.rst	text/plain	981 B	root/root	0644	2023-07-19 05:56:04
remove.rst	text/plain	306 B	root/root	0644	2023-07-19 05:56:04
remove_definitions.rst	text/plain	293 B	root/root	0644	2023-07-19 05:56:04
return.rst	text/plain	3.21 KB	root/root	0644	2023-07-19 05:56:04
separate_arguments.rst	text/plain	2.53 KB	root/root	0644	2023-07-19 05:56:04
set.rst	text/plain	4.39 KB	root/root	0644	2023-07-19 05:56:04
set_directory_properties.rst	text/plain	630 B	root/root	0644	2023-07-19 05:56:04
set_property.rst	text/plain	4.38 KB	root/root	0644	2023-07-19 05:56:04
set_source_files_properties.rst	text/plain	1.68 KB	root/root	0644	2023-07-19 05:56:04
set_target_properties.rst	text/plain	758 B	root/root	0644	2023-07-19 05:56:04
set_tests_properties.rst	text/plain	624 B	root/root	0644	2023-07-19 05:56:04
site_name.rst	text/plain	304 B	root/root	0644	2023-07-19 05:56:04
source_group.rst	text/plain	2.18 KB	root/root	0644	2023-07-19 05:56:04
string.rst	text/plain	18.51 KB	root/root	0644	2023-07-19 05:56:04
subdir_depends.rst	text/plain	306 B	root/root	0644	2023-07-19 05:56:04
subdirs.rst	text/plain	1.05 KB	root/root	0644	2023-07-19 05:56:04
target_compile_definitions.rst	text/plain	2.15 KB	root/root	0644	2023-07-19 05:56:04
target_compile_features.rst	text/plain	1.82 KB	root/root	0644	2023-07-19 05:56:04
target_compile_options.rst	text/plain	2.13 KB	root/root	0644	2023-07-19 05:56:04
target_include_directories.rst	text/plain	3.57 KB	root/root	0644	2023-07-19 05:56:04
target_link_directories.rst	text/plain	2.77 KB	root/root	0644	2023-07-19 05:56:04
target_link_libraries.rst	text/plain	16.66 KB	root/root	0644	2023-07-19 05:56:04
target_link_options.rst	text/plain	2.14 KB	root/root	0644	2023-07-19 05:56:04
target_precompile_headers.rst	text/plain	5.6 KB	root/root	0644	2023-07-19 05:56:04
target_sources.rst	text/plain	7.99 KB	root/root	0644	2023-07-19 05:56:04
try_compile.rst	text/plain	13.25 KB	root/root	0644	2023-07-19 05:56:04
try_run.rst	text/plain	5.71 KB	root/root	0644	2023-07-19 05:56:04
unset.rst	text/plain	1.54 KB	root/root	0644	2023-07-19 05:56:04
use_mangled_mesa.rst	text/plain	475 B	root/root	0644	2023-07-19 05:56:04
utility_source.rst	text/plain	977 B	root/root	0644	2023-07-19 05:56:04
variable_requires.rst	text/plain	784 B	root/root	0644	2023-07-19 05:56:04
variable_watch.rst	text/plain	1.76 KB	root/root	0644	2023-07-19 05:56:04
while.rst	text/plain	891 B	root/root	0644	2023-07-19 05:56:04
write_file.rst	text/plain	705 B	root/root	0644	2023-07-19 05:56:04

Team Anon Force

https://t.me/Professor6T9x