cmake/Help/prop_tgt/LOCATION_CONFIG.rst

21 lines
940 B
ReStructuredText
Raw Normal View History

2014-08-03 19:52:23 +02:00
LOCATION_<CONFIG>
-----------------
Read-only property providing a target location on disk.
A read-only property that indicates where a target's main file is
2019-11-11 23:01:05 +01:00
located on disk for the configuration ``<CONFIG>``. The property is
2014-08-03 19:52:23 +02:00
defined only for library and executable targets. An imported target
may provide a set of configurations different from that of the
importing project. By default CMake looks for an exact-match but
otherwise uses an arbitrary available configuration. Use the
2019-11-11 23:01:05 +01:00
:prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` property to map imported
configurations explicitly.
2014-08-03 19:52:23 +02:00
Do not set properties that affect the location of a target after
reading this property. These include properties whose names match
2019-11-11 23:01:05 +01:00
``(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?``,
``(IMPLIB_)?(PREFIX|SUFFIX)``, or :prop_tgt:`LINKER_LANGUAGE`.
Failure to follow this rule is not diagnosed and leaves
the location of the target undefined.