التابع IO.write في روبي

يفتح التابع write الملف، ويتموضع (seeks) اختياريا عند الإزاحة offset المعطاة (انظر فقرة البنية العامة)، ثم يكتب string، ثم يعيد طول السلسلة النصية المكتوبة. يضمن التابع write أن يُغلق الملف قبل العودة. إذا لم يتم إعطاء offset في وضع الكتابة (write mode)، سيتم اقتطاع الملف. خلاف ذلك، لا يُقتطع.

إن كانت الوسيط الأخيرة عبارة عن قاموس، فسيحدد الخيارات الداخلية للدالة open()‎. يقبل المفاتيح التالية:

‎:encoding

سلسلة نصية أو ترميز

يحدد ترميز السلسلة النصية المقروءة. انظر صفحة Encoding.aliases للتعرف على الترميزات الممكنة.

‎:mode

سلسلة نصية أو عدد صحيح

يحدد الوسيط mode لأجل الدالة open()‎. يجب أن يبدأ بـ "w" أو "a" أو "r+‎" وإلا سيتسبب في حدوث خطأ. انظر صفحة ::new لمزيد من قائمة الأوضاع الممكنة.

‎:perm

عدد صحيح

يحدد الوسيط perm لأجل الدالة open()‎.

‎:open_args

مصفوفة

يحدد الوسائط الممررة إلى open()‎ على هيئة مصفوفة. لا يمكن استخدام هذا المفتاح مع مفاتيح أخرى.

البنية العامة

write(name, string [, offset])  → integer
write(name, string [, offset] [, opt])→ integer‎

المعاملات

name‎

اسم الملف

string‎

سلسلة نصية

offset‎

عدد صحيح يمثل الإزاحة

opt‎

خيارات

أمثلة

مثال على استخدام التابع write‎:

IO.write("testfile", "0123456789", 20)  #=> 10
# File could contain:  "This is line one\nThi0123456789two\nThis is line three\nAnd so on...\n"
IO.write("testfile", "0123456789")      #=> 10
# File would now read: "0123456789"‎

أنظر أيضا

• التابع try_convert: يحاول تحويل الوسيط obj (انظر فقرة البنية العامة) إلى مجرى د/خ (IO)، باستخدام التابع #to_io. تم يعيد مجرى د/خ IO المُحوّل، أو يعيد nil إذا تعذر تحويل obj لأي سبب من الأسباب.
• التابع <<: مجرى الإخراج النصي String - يكتب obj (انظر فقرة البنية العامة) في المجرى ios. سيتم تحويل obj إلى سلسلة نصية باستخدام to_s.

مصادر

• قسم التابع write‎ في الصنف IO‎ في توثيق روبي الرسمي.