التابع ARGF.puts في روبي

من موسوعة حسوب
< Ruby‏ | ARGF

يكتب التابع puts الكائن أو الكائنات المُمرَّرة إليه على المجرى ios (اختصارًا للعبارة Input Output Stream) ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ.

يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن مرِّرت مصفوفةٌ إلى التابع puts كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع to_s تلقائيًّا. عند استدعاء التابع puts دون تمرير وسائط، سيطبع سطرًا جديدًا فارغًا.

لاحظ أنّ التابع puts يستخدم دائمًا محارف الأسطر الجديدة ولا يتأثر بفاصل سجل المخرجات (\$).

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

puts(obj, ...)  nil

المعاملات

obj

الكائن المراد كتابته على المجرى ios.

الكائنات الأخرى المراد كتابتها على المجرى ios.

القيم المعادة

تعاد القيمة nil.

أمثلة

مثالٌ على استخدام التابع puts:

$stdout.puts("this", "is", ["a", "test"])  # => 

سيطبع هذا المثال بعد تنفيذه الناتج التالي:
this
is
a
test

انظر أيضًا

  • التابع print: يطبع الكائن أو الكائنات المُمرَّرة إليه على المجرى ios.
  • التابع printf: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى ios بعد تنسيقها بشكل معين.
  • التابع putc: يكتب محرفًا واحدًا على المجرى ios.
  • التابع gets: يجلب السطر التالي من الملف الحالي في المجرى ARGF.
  • التابع readline: يقرأ السطر التالي من الملف الحالي في المجرى ARGF.

مصادر