التابع IO.puts
في روبي
يكتب التابع puts
الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة nil
. يجب أن يكون المجرى مفتوحًا في وضعية الكتابة.
إن كان الكائن المعطى مصفوفةً، فسيكتب التابع puts
كل عنصر من عناصرها في سطر جديد.
إن لم يكن الكائن سلسلة نصية أو مصفوفة، فسيتم تحويله إلى سلسلة نصية عن طريق استدعاء تابعه to_s
.
في حال استدعاء التابع puts
بدون تمرير أي شيء إليه، فسيكتب سطرًا جديدًا واحدًا في المجرى.
لاحظ أنَّ puts
يستخدم دائمًا الأسطر الجديدة، ولا يتأثر بفاصل سجل الإخراج ($\
).
البنية العامة
puts(obj, ...) → nil
المعاملات
obj
سلسلة نصية أو مصفوفة يراد كتابة محتواها في المجرى المعطى.
...
الكائنات الأخرى المراد كتابة محتواها ضمن المجرى المعطى.
القيمة المعادة
تعاد القيمة nil
بعد تنفيذ العملية.
أمثلة
مثال على استخدام التابع puts
:
$stdout.puts("this", "is", ["a", "test"])
الناتج:
this
is
a
test
انظر أيضًا
- التابع
print
: يكتب الكائن (أو الكائنات) المُمرَّرة إليه في المجرى الذي استدعي معه ثم يُعيد القيمةnil
.
- التابع
putc
: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه.