เครื่องมือสําหรับ CcToolInfo

ข้อมูลเกี่ยวกับคอมไพเลอร์ C++ ที่ใช้

สมาชิก

• all_files
• ar_executable
• built_in_include_directories
• compiler
• compiler_executable
• cpu
• dynamic_runtime_lib
• gcov_executable
• ld_executable
• libc
• needs_pic_for_dynamic_libraries
• nm_executable
• objcopy_executable
• objdump_executable
• preprocessor_executable
• static_runtime_lib
• strip_executable
• sysroot
• target_gnu_system_name
• to_json
• to_proto

all_files

depset CcToolchainInfo.all_files

แสดงผลไฟล์ Toolchain ทั้งหมด (เพื่อให้ส่งไปยังการดำเนินการโดยใช้ Toolchain นี้เป็นอินพุตได้)

ar_executable

string CcToolchainInfo.ar_executable

เส้นทางไปยังไบนารี ar

built_in_include_directories

list CcToolchainInfo.built_in_include_directories

แสดงผลรายการไดเรกทอรีในตัวของคอมไพเลอร์

compiler

string CcToolchainInfo.compiler

คอมไพเลอร์ C++ อาจแสดงผล None

compiler_executable

string CcToolchainInfo.compiler_executable

เส้นทางไปยังไบนารีคอมไพเลอร์

cpu

string CcToolchainInfo.cpu

CPU เป้าหมายของ Toolchain C++ อาจแสดงผล None

dynamic_runtime_lib

depset CcToolchainInfo.dynamic_runtime_lib(feature_configuration)

แสดงผลไฟล์จากแอตทริบิวต์ `dynamic_runtime_lib` (เพื่อให้ส่งไปยังการดำเนินการโดยใช้ Toolchain นี้เป็นอินพุตได้) ผู้เรียกสามารถตรวจสอบว่า feature_configuration เปิดใช้ฟีเจอร์ `static_link_cpp_runtimes` หรือไม่ (หากไม่ ก็ไม่จำเป็นต้องใช้ `static_runtime_lib` หรือ `dynamic_runtime_lib`) และใช้ `static_runtime_lib` หากโหมดการลิงก์แบบคงที่ทำงานอยู่

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
feature_configuration	required 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 หากไม่ใช่จะแสดงผลเป็น "เท็จ" กำหนดว่าควรใช้ -fPIC สำหรับการคอมไพล์ C++ ของกฎนี้หรือไม่ โดยขึ้นอยู่กับ Toolchain C++ และการมีตัวเลือก `--force_pic` ของ Bazel

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
feature_configuration	required 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

เส้นทางไปยังไบนารี Preprocessor

static_runtime_lib

depset CcToolchainInfo.static_runtime_lib(feature_configuration)

แสดงผลไฟล์จากแอตทริบิวต์ `static_runtime_lib` (เพื่อให้ส่งไปยังการดำเนินการโดยใช้ Toolchain นี้เป็นอินพุตได้) ผู้เรียกควรตรวจสอบว่า feature_configuration เปิดใช้ฟีเจอร์ `static_link_cpp_runtimes` หรือไม่ (หากไม่ ก็ไม่ควรใช้ `static_runtime_lib` หรือ `dynamic_runtime_lib`) และใช้ `dynamic_runtime_lib` หากโหมดการลิงก์แบบไดนามิกทำงานอยู่

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
feature_configuration	required Feature configuration ที่จะค้นหา

strip_executable

string CcToolchainInfo.strip_executable

เส้นทางไปยังไบนารี strip

sysroot

string CcToolchainInfo.sysroot

แสดงผล sysroot ที่จะใช้ หากคอมไพเลอร์ Toolchain ไม่รองรับ sysroot ที่แตกต่างกัน หรือ sysroot เหมือนกับ sysroot เริ่มต้น เมธอดนี้จะแสดงผล None อาจแสดงผล None

target_gnu_system_name

string CcToolchainInfo.target_gnu_system_name

ชื่อระบบ GNU อาจแสดงผล None

to_json

string CcToolchainInfo.to_json()

เลิกใช้งาน API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าใช้ API นี้ ระบบจะปิด เมื่อใช้ Flag ---incompatible_struct_has_no_methods ใช้ Flag นี้เพื่อยืนยันว่าโค้ดของคุณทำงานได้โดยไม่พึ่งพา API ที่กำลังจะถูกนำออก
สร้างสตริง JSON จากพารามิเตอร์โครงสร้าง วิธีนี้จะใช้ได้ก็ต่อเมื่อองค์ประกอบ struct ทั้งหมด (รวมถึงที่ซ้อนอยู่) เป็นสตริง, int, บูลีน, struct อื่นๆ, รายการของชนิดข้อมูลเหล่านี้ หรือพจนานุกรมที่มีคีย์และค่าของสตริงชนิดดังกล่าว ระบบจะใช้อักขระหลีกแทนเครื่องหมายคำพูดและบรรทัดใหม่ในสตริง ตัวอย่าง

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) แทน ซึ่งใช้ได้กับค่าอื่นๆ ที่ไม่ใช่ structs และไม่ทำให้เนมสเปซของฟิลด์ structs เสียหาย

to_proto

string CcToolchainInfo.to_proto()

เลิกใช้งาน API นี้เลิกใช้งานแล้วและจะถูกนำออกเร็วๆ นี้ โปรดอย่าใช้ API นี้ ระบบจะปิด เมื่อใช้ Flag ---incompatible_struct_has_no_methods ใช้ Flag นี้เพื่อยืนยันว่าโค้ดของคุณทำงานได้โดยไม่พึ่งพา API ที่กำลังจะถูกนำออก
สร้างข้อความจากพารามิเตอร์ struct วิธีนี้จะใช้ได้ก็ต่อเมื่อองค์ประกอบ struct ทั้งหมด (รวมถึงที่ซ้อนอยู่) เป็นสตริง, int, บูลีน, struct หรือพจนานุกรม หรือรายการอื่นๆ ที่เป็นชนิดข้อมูลเหล่านี้ ระบบจะใช้อักขระหลีกแทนเครื่องหมายคำพูดและบรรทัดใหม่ในสตริง และจะวนซ้ำคีย์ Struct ตามลำดับที่จัดเรียง ตัวอย่าง

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) แทน