سيتم إطلاق BazelCon لعام 2022 في الفترة من 16 إلى 17 تشرين الثاني (نوفمبر) في نيويورك وعلى الإنترنت. التسجيل اليوم
جديد: انضم إلينا في يوم المنتدى في 15 تشرين الثاني (نوفمبر). التفاصيل والتسجيل:

ملف

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم إنشاء هذا العنصر خلال مرحلة التحليل لتمثيل ملف أو دليل ستتم قراءته أو كتابته أثناء مرحلة التنفيذ. وهو ليس بمقبض ملف مفتوحًا، ولا يمكن استخدامه لقراءة محتوى الملف أو كتابته مباشرةً. وبدلاً من ذلك، يمكنك استخدامه لإنشاء الرسم البياني للإجراء في وظيفة تنفيذ قاعدة من خلال تمريره إلى وظائف إنشاء الإجراء. يمكنك الاطِّلاع على صفحة القواعد لمزيد من المعلومات.

عند تمرير File إلى كائن Args بدون استخدام دالة map_each، يتم تحويله إلى سلسلة عبر أخذ قيمة حقل path الخاص به.

المنتسبون

اسم أساسي

string File.basename

الاسم الأساسي لهذا الملف. هذا هو اسم الملف داخل الدليل.

ديرنام

string File.dirname

اسم الدليل الذي يحتوي على هذا الملف. يتم الحصول عليها من path ودائمًا ما تكون مرتبطة بدليل التنفيذ.

إضافة

string File.extension

امتداد الملف لهذا الملف، تابعًا (لا يشمل) الفترة الزمنية الصحيحة. سلسلة فارغة إذا كان الاسم الأساسي للملف لا يتضمن أي نقاط.

is_directory

bool File.is_directory

عرض true إذا كان هذا دليلاً.

is_source

bool File.is_source

عرض "صحيح" إذا كان هذا ملف مصدر، أي أنه لم يتم إنشاؤه.

owner

Label File.owner

تصنيف الاستهداف الذي ينتج هذا الملف. قد يتم إرجاع None.

المسار

string File.path

مسار التنفيذ لهذا الملف، مرتبط بدليل التنفيذ لمساحة العمل. وهي تتكوّن من جزأين: الجزء الأول الاختياري باسم الجذر (راجِع أيضًا وحدة الجذر)، والجزء الثاني وهو short_path. قد يكون الجذر فارغًا، ويكون عادةً للملفات غير المنشأة. وبالنسبة إلى الملفات التي تم إنشاؤها، تتضمّن عادةً جزء مسار مخصصًا للإعداد يشفّر عناصر مثل بنية وحدة المعالجة المركزية (CPU) المستهدفة التي تم استخدامها أثناء إنشاء الملف المذكور. استخدِم short_path للمسار الذي يتم ربط الملف ضِمنه إذا كان الملف ضمن ملفات التشغيل الخاصة بالبرنامج الثنائي.

جذر

root File.root

الجذر الذي يقع فيه هذا الملف.

مسار_قصير

string File.short_path

مسار هذا الملف بالنسبة إلى جذره. يُستثنى من هذا الجذر المذكور أعلاه، أي الأجزاء الخاصة بالإعدادات الخاصة بالمسار. وهذا أيضًا هو المسار الذي يتم بموجبه ربط الملف إذا كان في ملفات تشغيل البرنامج الثنائي.

مسار_الشجرة_النسبية

string File.tree_relative_path

مسار هذا الملف المرتبط بجذر شجرة أصل أصله، في حال كان حقل is_directory للأصل أصل صحيحًا. لا يتوفّر tree_relative_path إلا للملفات الموسَّعة للدليل في أمر اتخاذ إجراء، مثل Args.add_all(). وبالنسبة إلى الأنواع الأخرى من الملفات، يُعد الوصول إلى هذا الحقل خطأً.