التابع File.rename
في روبي
يعيد التابع 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).