External program (external_program)

Opaque object representing an external program

Returned by

External program objects are returned by the following functions and methods:

External program methods

external_program.found()

Returns whether the executable was found.

Signature

bool found()


external_program.full_path()

Returns a string pointing to the script or executable.

NOTE: You should not need to use this method. Passing the object itself should work in all cases.

For example:

run_command(find_program('foo'), 'arg1', 'arg2')

Signature

(since 0.55.0)

str full_path()


external_program.path()

Deprecated: Use external_program.full_path() instead.

Returns a string pointing to the script or executable.

NOTE: You should not need to use this method. Passing the object itself should work in all cases.

For example:

run_command(find_program('foo'), 'arg1', 'arg2')

Signature

DEPRECATED

in 0.55.0

str path()


external_program.version()

The version number as a string, for example 1.2.8.

unknown if the program cannot determine the version via a --version argument.

Signature

(since 0.62.0)

str version()


The results of the search are