summaryrefslogtreecommitdiffstats
path: root/Help/command/return.rst
blob: 830992c25a7729f6569873b0c716d52ab01f7d86 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
return
------

Return from a file, directory or function.

.. code-block:: cmake

  return()

Returns from a file, directory or function.  When this command is
encountered in an included file (via :command:`include` or
:command:`find_package`), it causes processing of the current file to stop
and control is returned to the including file.  If it is encountered in a
file which is not included by another file, e.g.  a ``CMakeLists.txt``,
control is returned to the parent directory if there is one.  If return is
called in a function, control is returned to the caller of the function.

Note that a :command:`macro <macro>`, unlike a :command:`function <function>`,
is expanded in place and therefore cannot handle ``return()``.