التابع IO.puts‎ في روبي

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث

يكتب التابع 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: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه.

مصادر