CctoolchainInfo

每夜版 · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.7
有关所用 C++ 编译器的信息。

成员

all_files

depset CcToolchainInfo.all_files

返回所有工具链文件（以便它们可以作为输入传递给使用此工具链的操作）。

ar_executable

string CcToolchainInfo.ar_executable

ar 二进制文件的路径。

built_in_include_directories

list CcToolchainInfo.built_in_include_directories

返回编译器的内置目录列表。

编译器

string CcToolchainInfo.compiler

C++ 编译器。 可能会返回 None。

compiler_executable

string CcToolchainInfo.compiler_executable

编译器二进制文件的路径。

cpu

string CcToolchainInfo.cpu

C++ 工具链的目标 CPU。 可能会返回 None。

dynamic_runtime_lib

depset CcToolchainInfo.dynamic_runtime_lib(feature_configuration)

返回来自 `dynamic_runtime_lib` 属性的文件（以便它们可以作为输入传递给使用此工具链的操作）。调用方可以检查 feature_configuration 是否启用了“static_link_cpp_runtimes”功能（如果未启用，则无需使用“static_runtime_lib”或“dynamic_runtime_lib”），并在静态关联模式处于活动状态时使用“static_runtime_lib”。

参数

参数 说明
feature_configuration 必需
要查询的功能配置。

gcov_executable

string CcToolchainInfo.gcov_executable

gcov 二进制文件的路径。

ld_executable

string CcToolchainInfo.ld_executable

ld 二进制文件的路径。

libc

string CcToolchainInfo.libc

libc 版本字符串。 可能会返回 None。

needs_pic_for_dynamic_libraries

bool CcToolchainInfo.needs_pic_for_dynamic_libraries(feature_configuration)

如果相应规则的编译应应用 -fPIC，则返回 true，否则返回 false。根据 C++ 工具链和是否存在 `--force_pic` Bazel 选项，确定是否应为此规则的 C++ 编译应用 -fPIC。

参数

参数 说明
feature_configuration 必需
要查询的功能配置。

nm_executable

string CcToolchainInfo.nm_executable

nm 二进制文件的路径。

objcopy_executable

string CcToolchainInfo.objcopy_executable

objcopy 二进制文件的路径。

objdump_executable

string CcToolchainInfo.objdump_executable

objdump 二进制文件的路径。

preprocessor_executable

string CcToolchainInfo.preprocessor_executable

预处理器二进制文件的路径。

static_runtime_lib

depset CcToolchainInfo.static_runtime_lib(feature_configuration)

返回来自 `static_runtime_lib` 属性的文件（以便它们可以作为输入传递给使用此工具链的操作）。调用方应检查 feature_configuration 是否启用了 `static_link_cpp_runtimes` 功能（如果未启用，则不应使用 `static_runtime_lib` 或 `dynamic_runtime_lib`），并在动态链接模式处于活动状态时使用 `dynamic_runtime_lib`。

参数

参数 说明
feature_configuration 必需
要查询的功能配置。

strip_executable

string CcToolchainInfo.strip_executable

剥离二进制文件的路径。

sysroot

string CcToolchainInfo.sysroot

返回要使用的 sysroot。如果工具链编译器不支持不同的 sysroot，或者 sysroot 与默认 sysroot 相同，则此方法会返回 None。 可能会返回 None。

target_gnu_system_name

string CcToolchainInfo.target_gnu_system_name

GNU 系统名称。 可能会返回 None。

to_json

string CcToolchainInfo.to_json()

已弃用。此 API 已弃用，很快就会被移除。请勿依赖此功能。它已通过 ---incompatible_struct_has_no_methods 停用。使用此标志可验证您的代码是否与即将进行的移除操作兼容。
根据结构体形参创建 JSON 字符串。只有当所有结构元素（递归）都是字符串、整数、布尔值、其他结构、这些类型的列表或具有字符串键和这些类型的值的字典时，此方法才有效。字符串中的引号和换行符会进行转义。示例：
struct(key=123).to_json()
# {"key":123}

struct(key=True).to_json()
# {"key":true}

struct(key=[1, 2, 3]).to_json()
# {"key":[1,2,3]}

struct(key='text').to_json()
# {"key":"text"}

struct(key=struct(inner_key='text')).to_json()
# {"key":{"inner_key":"text"}}

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_json()
# {"key":[{"inner_key":1},{"inner_key":2}]}

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_json()
# {"key":{"inner_key":{"inner_inner_key":"text"}}}
。

已弃用：请改用 json.encode(x) 或 json.encode_indent(x)，它们适用于结构体以外的值，并且不会污染结构体字段命名空间。

to_proto

string CcToolchainInfo.to_proto()

已弃用。此 API 已弃用，很快就会被移除。请勿依赖此功能。它已通过 ---incompatible_struct_has_no_methods 停用。使用此标志可验证您的代码是否与即将进行的移除操作兼容。
根据结构体形参创建文本消息。仅当所有结构体元素（递归）都是字符串、整数、布尔值、其他结构体或字典或这些类型的列表时，此方法才有效。字符串中的引号和换行符会进行转义。结构键按排序顺序进行迭代。示例：
struct(key=123).to_proto()
# key: 123

struct(key=True).to_proto()
# key: true

struct(key=[1, 2, 3]).to_proto()
# key: 1
# key: 2
# key: 3

struct(key='text').to_proto()
# key: "text"

struct(key=struct(inner_key='text')).to_proto()
# key {
#   inner_key: "text"
# }

struct(key=[struct(inner_key=1), struct(inner_key=2)]).to_proto()
# key {
#   inner_key: 1
# }
# key {
#   inner_key: 2
# }

struct(key=struct(inner_key=struct(inner_inner_key='text'))).to_proto()
# key {
#    inner_key {
#     inner_inner_key: "text"
#   }
# }

struct(foo={4: 3, 2: 1}).to_proto()
# foo: {
#   key: 4
#   value: 3
# }
# foo: {
#   key: 2
#   value: 1
# }

已弃用：请改用 proto.encode_text(x)。