التابع `File.to_path` في روبي

يعيد التابع to_path سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. لا يعمل هذا التابع على توحيد شكل وبنية المسار (normalize).

قد لا يشير اسم المسار إلى الملف المقابل للملف المعطى. على سبيل المثال، يصبح اسم المسار خاويًا (void) عندما يُنقَل أو يحذف الملف.

يرمي هذا التابع الاسثناء IOError للملف المعطى إذا كان قد أنشئ باستعمال File::Constants::TMPFILE لأنه لا يملك اسم مسارٍ.

البنية العامة

to_path → filename

تعاد سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف المعطى.

مثال على استعمال التابع to_path:

File.new("testfile").path               #=> "testfile"
File.new("/tmp/../tmp/xxx", "w").path   #=> "/tmp/../tmp/xxx"

التابع absolute_path: يحول اسم مسار محدَّد إلى مسار مطلق.
التابع dirname: يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار.