الفرق بين المراجعتين ل"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).