الفرق بين المراجعتين لصفحة: «Ruby/File/rename»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. |
جميل-بيلوني (نقاش | مساهمات) إضافة شرح |
||
سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>File.rename</code> في روبي}}</noinclude> | <noinclude>{{DISPLAYTITLE: التابع <code>File.rename</code> في روبي}}</noinclude> | ||
يعيد التابع <code>rename</code> | يعيد التابع <code>rename</code> تسمية ملف محدَّد إلى اسم جديد. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">rename(old_name, new_name) → 0</syntaxhighlight> | <syntaxhighlight lang="ruby">rename(old_name, new_name) → 0</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>old_name</code> === | |||
اسم الملف القديم المراد تغييره. | |||
=== <code>new_name</code> === | |||
الاسم الجديد المراد تغيير اسم الملف <code>old_name</code> إليه. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تعاد القيمة 0 بعد تسمية الملف <code>old_name</code> إلى الاسم <code>new_name</code> الجديد، أو يرمى الخطأ <code>[[Ruby/SystemCallError|SystemCallError]]</code> إن لم يكن الإمكان إعادة تسمية الملف <code>old_name</code> لأي سبب كان. | |||
==أمثلة== | ==أمثلة== | ||
مثال على استعمال التابع <code></code>: | مثال على استعمال التابع <code></code>: | ||
سطر 12: | سطر 20: | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/File/absolute path|absolute_path]]</code>: يحول اسم مسار محدَّد إلى مسار مطلق. | |||
* التابع <code>[[Ruby/File/dirname|dirname]]</code>: يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار. | |||
* التابع <code>[[Ruby/File/link|link]]</code>: ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). | |||
==مصادر== | ==مصادر== |
المراجعة الحالية بتاريخ 12:47، 29 نوفمبر 2018
يعيد التابع rename
تسمية ملف محدَّد إلى اسم جديد.
البنية العامة
rename(old_name, new_name) → 0
المعاملات
old_name
اسم الملف القديم المراد تغييره.
new_name
الاسم الجديد المراد تغيير اسم الملف old_name
إليه.
القيمة المعادة
تعاد القيمة 0 بعد تسمية الملف old_name
إلى الاسم new_name
الجديد، أو يرمى الخطأ SystemCallError
إن لم يكن الإمكان إعادة تسمية الملف old_name
لأي سبب كان.
أمثلة
مثال على استعمال التابع :
File.rename("afile", "afile.bak") #=> 0
انظر أيضا
- التابع
absolute_path
: يحول اسم مسار محدَّد إلى مسار مطلق.
- التابع
dirname
: يعيد جميع مكونات المسار المعطى لملفٍ باستثناء المكون الأخير (الاسم الأساسي [basename]) الذي يلي آخر فاصل في المسار. - التابع
link
: ينشئ اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link).