الفرق بين المراجعتين لصفحة: «Ruby/File/rename»

من موسوعة حسوب
< Ruby‏ | File
إنشاء الصفحة.
 
إضافة شرح
 
سطر 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).


مصادر