Imported Upstream version 3.25.0
[platform/upstream/cmake.git] / Help / command / get_test_property.rst
1 get_test_property
2 -----------------
3
4 Get a property of the test.
5
6 .. code-block:: cmake
7
8   get_test_property(test property VAR)
9
10 Get a property from the test.  The value of the property is stored in
11 the variable ``VAR``.  If the test property is not found, the behavior
12 depends on whether it has been defined to be an ``INHERITED`` property
13 or not (see :command:`define_property`).  Non-inherited properties will
14 set ``VAR`` to "NOTFOUND", whereas inherited properties will search the
15 relevant parent scope as described for the :command:`define_property`
16 command and if still unable to find the property, ``VAR`` will be set to
17 an empty string.
18
19 For a list of standard properties you can type
20 :option:`cmake --help-property-list`.
21
22 See also the more general :command:`get_property` command.