可执行目标 (exe 扩展 build_tgt)

一个可执行文件

由以下函数和方法返回

可执行目标对象由以下函数和方法返回

• executable()

继承的方法

build_tgt.extract_all_objects()

作用与 extract_objects 相同，但返回此目标生成的所有目标文件。

默认情况下，只返回为该目标构建的对象，以保持与先前版本的向后兼容性。recursive 关键字参数的默认值将在未来版本中最终更改为 true。

# Acts the same as `extract_objects`, but returns all object files generated
extracted_obj extract_all_objects(
  recursive : bool  # Also return objects passed to the `objects` argument of this target
)

参数

build_tgt.extract_all_objects() 方法接受以下关键字参数

名称	类型	描述	标签
recursive	bool	还返回传递给该目标 objects 参数的对象。	(自 0.46.0) default = true

---

build_tgt.extract_objects()

返回一个不透明的值，表示为这些源文件生成的的目标文件。这通常用于获取单个目标文件并将它们链接到单元测试，或者使用自定义标志编译一些源文件。要在另一个构建目标中使用目标文件，请使用 build_target() 或 declare_dependency() 的 objects: 关键字参数，或将它们包含在 custom_target() 的命令行中。

# Returns an opaque value representing the object files generated for those
extracted_obj extract_objects(
  str | file source...,  # Source filenames for which the built objects should be extracted
)

参数

该方法接受 1 到 infinity 之间的可变参数 (source...)，类型为 str | file。

应提取构建对象的源文件名。

---

build_tgt.found()

始终返回 true。此函数旨在使可执行对象与 external_program 对象的功能兼容。这简化了使用可执行文件而不是 external_program 的用例。

bool found()

---

build_tgt.full_path()

返回指向结果目标文件的完整路径。注意：在大多数情况下，使用对象本身将与之完成相同的任务，并且还允许 Meson 正确地设置目标之间的依赖关系。如果这对您不起作用，请提交错误报告。

str full_path()

---

build_tgt.name()

返回目标的名称。

str name()

---

build_tgt.path()

与 build_tgt.full_path() 的作用完全相同。注意：此函数仅为了与 external_program 对象的兼容性而保留。一旦 external_program 对象中也已弃用的对应 path() 函数被删除，它也将被删除。

str path()

---

build_tgt.private_dir_include()

返回一个值，其作用类似于 include_directories()，但指向该目标的私有目录。通常只在另一个目标需要访问该目标的一些生成的内部头文件时才需要。

inc private_dir_include()

---