CcToolchainInfo

Nightly · 8.4 · 8.3 · 8.2 · 8.1 · 8.0 · 7.6
所用 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

strip 二進位檔的路徑。

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