التابع File.rename في روبي

من موسوعة حسوب
< Ruby‏ | File

يعيد التابع 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).


مصادر