التابع File.new في روبي
يفتح التابع new ملفًا محدَّدًا وبوضع معيَّن ثم يعيد كائنًا جديدًا من النوع File.
البنية العامة
new(filename, mode="r" [, opt]) → file
new(filename [, mode [, perm]] [, opt]) → file
عندما يكون الملف قيد الإنشاء، فمن الممكن أن تُعطَى بتات الأذونات عبر المعامل perm. تتعلق بتات الأذونات perm والنمط mode بالمنصة المستعملة. في الأنظمة الشبهة بيونكس، اطلع على صفحة الدليل man للدالة open(2) والدالة chmod(2) لمزيد من التفاصيل.
يكون الكائن File الجديد المعاد في وضع التخزين (buffered mode) أو الوضع غير المتزامن (non-sync mode) إلا إذا كان المعامل filename هو tty. اطلع على توثيق التوابع IO.flush، و IO.fsync، و IO.datasync، و IO.sync حول الوضع المتزامن (sync mode).
المعاملات
filename
اسم الملف المراد فتحه.
mode
وضع الملف المراد فتحه فيه. اطلع على توثيق التابع IO.new لمزيد من المعلومات حول قيم هذا المعامل.
opt
خيارات إضافية. اطلع على توثيق التابع IO.new لمزيد من المعلومات حول قيم هذا المعامل.
perm
بتات الأذونات التي ستُعيَّن للملف المراد فتحه.
القيمة المعادة
يعاد كائن جديد من النوع File يمثِّل الملف filename بعد فتحه.
أمثلة
مثال على استعمال التابع new:
f = File.new("testfile", "r")
f = File.new("newfile", "w+")
f = File.new("newfile", File::CREAT|File::TRUNC|File::RDWR, 0644)
انظر أيضا
- التابع
open: يشبه التابعnewتمامًا إن لم تعطَ كتلة برمجية معه أو سيمُرَّر الملف بعد فتحه (الكائنFile) إلى الكتلة ثم سيُغلق تلقائيًّا عند انتهاء تنفيذ الكتلة.