ไฟล์

รายงานปัญหา ดูแหล่งที่มา รุ่น Nightly · 7.4 7.3 · 7.2 · 7.1 · 7.0 · 6.5

ออบเจ็กต์นี้สร้างขึ้นในระหว่างช่วงการวิเคราะห์เพื่อแสดงไฟล์หรือไดเรกทอรีที่จะอ่านหรือเขียนในระหว่างขั้นตอนการดำเนินการ ข้อมูลนี้ไม่ใช่แฮนเดิลไฟล์ที่เปิดอยู่ และไม่สามารถใช้เพื่ออ่านหรือเขียนเนื้อหาไฟล์โดยตรง แต่คุณจะใช้เพื่อสร้างกราฟการดำเนินการในฟังก์ชันการใช้งานกฎได้โดยการส่งต่อไปให้กับฟังก์ชันการสร้างการดำเนินการ ดูข้อมูลเพิ่มเติมได้ที่หน้ากฎ

เมื่อมีการส่ง File ไปยังออบเจ็กต์ Args โดยไม่ใช้ฟังก์ชัน map_each ระบบจะแปลงเป็นสตริงโดยใช้ค่าของช่อง path

สมาชิก

ชื่อฐาน

string File.basename

ชื่อพื้นฐานของไฟล์นี้ นี่คือชื่อไฟล์ภายในไดเรกทอรี

dirname

string File.dirname

ชื่อไดเรกทอรีที่มีไฟล์นี้ ซึ่งได้มาจาก path และสัมพันธ์กับไดเรกทอรีการดำเนินการเสมอ

ส่วนขยาย

string File.extension

นามสกุลของไฟล์นี้ ตามหลัง (ไม่รวม) จุดขวาสุด สตริงว่างหากชื่อพื้นฐานของไฟล์ไม่มีจุด

is_directory

bool File.is_directory

แสดงค่า "จริง" หากเป็นไดเรกทอรี ค่านี้แสดงประเภทที่ไฟล์ได้รับการประกาศ (เช่น ctx.actions.declare_directory) ไม่ใช่ประเภทในระบบไฟล์ ซึ่งอาจแตกต่างกัน

is_source

bool File.is_source

แสดงค่า "จริง" หากไฟล์นี้เป็นไฟล์ต้นฉบับ ซึ่งไม่ได้สร้างขึ้น 

bool File.is_symlink

แสดงค่า "จริง" หากเป็นไดเรกทอรี ค่านี้แสดงถึงประเภทที่ไฟล์ได้รับการประกาศ (เช่น ctx.actions.declare_symlink) ไม่ใช่ประเภทในระบบไฟล์ ซึ่งอาจแตกต่างกัน

เจ้าของ

Label File.owner

ป้ายกํากับของเป้าหมายที่สร้างไฟล์นี้ อาจแสดงผล None

เส้นทาง

string File.path

เส้นทางการดําเนินการของไฟล์นี้ซึ่งสัมพันธ์กับไดเรกทอรีการดําเนินการของพื้นที่ทํางาน ประกอบด้วย 2 ส่วน ส่วนแรกเป็นตัวเลือกที่เรียกว่า root (ดูโมดูล root ด้วย) และส่วนที่สองคือ short_path รูทอาจว่างเปล่า ซึ่งมักจะเป็นเช่นนั้นสำหรับไฟล์ที่ไม่ได้สร้างขึ้น สำหรับไฟล์ที่สร้างขึ้น โดยทั่วไปจะมีส่วนของเส้นทางเฉพาะการกำหนดค่าซึ่งเข้ารหัสข้อมูลต่างๆ เช่น สถาปัตยกรรม CPU เป้าหมายที่ใช้ขณะสร้างไฟล์ดังกล่าว ใช้ short_path สำหรับเส้นทางที่ระบบแมปไฟล์หากอยู่ในไฟล์รันไทม์ของไบนารี

รูท

root File.root

รูทด้านล่างที่มีไฟล์นี้อยู่

short_path

string File.short_path

เส้นทางของไฟล์นี้ซึ่งเกี่ยวข้องกับรูท ซึ่งจะยกเว้นรากที่กล่าวไว้ข้างต้น ซึ่งก็คือส่วนย่อยของเส้นทางเฉพาะการกำหนดค่า เส้นทางนี้ยังเป็นเส้นทางที่ระบบแมปไฟล์ด้วยหากอยู่ในไฟล์รันไทม์ของไบนารี

tree_relative_path

string File.tree_relative_path

เส้นทางของไฟล์นี้สัมพันธ์กับรูทของต้นไม้ของบรรพบุรุษ หากช่อง is_directory ของบรรพบุรุษเป็น "จริง" tree_relative_path ใช้ได้เฉพาะกับไฟล์แบบขยายของไดเรกทอรีในคำสั่งการดำเนินการ เช่น Args.add_all() สำหรับไฟล์ประเภทอื่นๆ การเข้าถึงช่องนี้จะเป็นข้อผิดพลาด