التابع IO.puts
في روبي
يكتب التابع puts
الكائن(اات) المعطى في مجرى د/خ ios
. ويكتب سطرًا جديدا بعد أي سطر لا ينتهي بالفعل بمحرف السطر الجديد. ثم يعيد nil
.
يجب أن يكون المجرى مفتوحًا في وضعية الكتابة. إن كان الوسيط المعطى مصفوفة، فسيكتب التابع puts
كل عنصر من عناصر المصفوفة في سطر جديد. سيتم تحويل كل كائن لا يساوي سلسلة نصية أو مصفوفة عن طريق استدعاء تابعه to_s
. في حال استدعائه بدون وسائط، فستقوم بإخراج سطر جديد واحد.
produces:
لاحظ أن puts
يستخدم دائماً السطور الجديدة، ولا يتأثر بفاصل سجل الإخراج ($\
).
البنية العامة
puts(obj, ...) → nil
المعاملات
obj
كائن
...
القيمة المُعادة
أمثلة
مثال على استخدام التابع puts
:
$stdout.puts("this", "is", ["a", "test"])
انظر أيضا
- التابع
putc
: إن كان الوسيط المعطىobj
(انظر فقرة البنية العامة) عددًاNumeric
، فسيكتب الحرف الذي يكون رمزه هو البايت الأقل دلال (least-significant byte) منobj
. وإن كانobj
سلسلة نصيةString
، فسيكتب أول حرف منobj
في مجرى د/خios
. خلاف ذلك، سيُطلق الاستثناءTypeError
. - التابع
pwrite
: يكتب السلسلة النصية المعطاة (انظر فقرة البنية العامة) في مجرى د/خios
عند موضع الإزاحةoffset
باستخدام استدعاء النظام pwrite (). هذا مفيد مقارنة بالجمع بين#seek
و#write
في كونه ذريًا (atomic)، مما يسمح لعدة مهام فرعية/عمليات بالتشارك في نفس مجرى د/خIO
لقراءة الملف من مواضع مختلفة. هذا سيتجاوز أي مساحة تخزين مؤقت للمستخدمين من طبقة مجرى د/خIO
. سيعيد عدد البايتات المكتوبة. وسيُطلق الاستثناءSystemCallError
في حال حدوث خطأ، أوNotImplementedError
إذا لم يكن نظام الشغيل يدعم استدعاء النظام.