LOCATION_CONFIG.rst 940 B

1234567891011121314151617181920
  1. LOCATION_<CONFIG>
  2. -----------------
  3. Read-only property providing a target location on disk.
  4. A read-only property that indicates where a target's main file is
  5. located on disk for the configuration ``<CONFIG>``. The property is
  6. defined only for library and executable targets. An imported target
  7. may provide a set of configurations different from that of the
  8. importing project. By default CMake looks for an exact-match but
  9. otherwise uses an arbitrary available configuration. Use the
  10. :prop_tgt:`MAP_IMPORTED_CONFIG_<CONFIG>` property to map imported
  11. configurations explicitly.
  12. Do not set properties that affect the location of a target after
  13. reading this property. These include properties whose names match
  14. ``(RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?``,
  15. ``(IMPLIB_)?(PREFIX|SUFFIX)``, or :prop_tgt:`LINKER_LANGUAGE`.
  16. Failure to follow this rule is not diagnosed and leaves
  17. the location of the target undefined.