库目标 (lib 扩展了 build_tgt)

表示共享库或静态库

扩展自

库目标由以下子类型扩展

返回值

库目标对象由以下函数和方法返回

继承方法

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()

返回一个表示为此目标源文件生成的 .o 文件的不透明值。这通常用于获取单个 .o 文件并将它们链接到单元测试,或者使用自定义标志编译一些源文件。要在另一个构建目标中使用 .o 文件,请在 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
)

参数

该方法接受 1infinity 之间类型的变长参数 (source...) str | file

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


build_tgt.found()

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

签名

(自 0.59.0 起)

bool found()


build_tgt.full_path()

返回指向结果目标文件的完整路径。注意:在大多数情况下,使用对象本身与使用此方法的作用相同,并且还可以让 Meson 正确设置跨目标依赖项。如果这对你不起作用,请提交错误报告。

签名

str full_path()


build_tgt.name()

返回目标的名称。

签名

(自 0.54.0 起)

str name()


build_tgt.path()

build_tgt.full_path() 做完全相同的事情。注意:此函数仅保留与 external_program 对象兼容。一旦 external_program 对象中对应的已弃用函数 path() 被删除,它也会被删除。

签名

(自 0.59.0 起)

已弃用

在 0.59.0 中

str path()


build_tgt.private_dir_include()

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

签名

inc private_dir_include()


搜索结果为