التابع File.path في روبي

من موسوعة حسوب
< Ruby‏ | File

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

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

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

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

path  filename
to_path  filename

القيمة المعادة

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

أمثلة

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

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

انظر أيضا

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

مصادر