الفرق بين المراجعتين ل"Ruby/File/to path"

من موسوعة حسوب
< Ruby‏ | File
اذهب إلى التنقل اذهب إلى البحث
(إنشاء الصفحة.)
 
ط
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE: التابع <code>File.path</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE: التابع <code>File.to_path</code> في روبي}}</noinclude>
يعيد التابع <code>path</code> سلسلة نصية تمثِّل المسار المعطى.
+
يعيد التابع <code>to_path</code> سلسلة نصية تمثِّل المسار الذي استُعمِل لإنشاء الملف الذي استدعي معه. لا يعمل هذا التابع على توحيد شكل وبنية المسار (normalize).
  
 +
قد لا يشير اسم المسار إلى الملف المقابل للملف المعطى. على سبيل المثال، يصبح اسم المسار خاويًا (void) عندما يُنقَل أو يحذف الملف.
 +
 +
يرمي هذا التابع الاسثناء <code>[[Ruby/IOError|IOError]]</code> للملف المعطى إذا كان قد أنشئ باستعمال <code>File::Constants::TMPFILE</code> لأنه لا يملك اسم مسارٍ. 
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby">to_path → filename</syntaxhighlight>
 
<syntaxhighlight lang="ruby">to_path → filename</syntaxhighlight>
  
 
==القيمة المعادة==
 
==القيمة المعادة==
تعاد سلسلة نصية تمثِّل المسار <code>to_path</code> المعطى.
+
تعاد [[Ruby/String|سلسلة نصية]] تمثِّل المسار الذي استُعمِل لإنشاء الملف المعطى. 
  
 
==أمثلة==
 
==أمثلة==
مثال على استعمال التابع <code>path</code>:
+
مثال على استعمال التابع <code>to_path</code>:
 
<syntaxhighlight lang="ruby">File.new("testfile").path              #=> "testfile"
 
<syntaxhighlight lang="ruby">File.new("testfile").path              #=> "testfile"
 
File.new("/tmp/../tmp/xxx", "w").path  #=> "/tmp/../tmp/xxx"</syntaxhighlight>
 
File.new("/tmp/../tmp/xxx", "w").path  #=> "/tmp/../tmp/xxx"</syntaxhighlight>

المراجعة الحالية بتاريخ 08:44، 1 ديسمبر 2018

يعيد التابع 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]) الذي يلي آخر فاصل في المسار.

مصادر