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