الفرق بين المراجعتين لصفحة: «Ruby/ARGF/puts»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 5: | سطر 5: | ||
يكتب التابع <code>puts</code> الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> (اختصارًا للعبارة Input Output Stream) ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | يكتب التابع <code>puts</code> الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> (اختصارًا للعبارة Input Output Stream) ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | ||
يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن مرِّرت مصفوفةٌ إلى التابع <code>puts</code> كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع [[Ruby/ARGF/to_s | <code>to_s</code>]] تلقائيًّا. عند استدعاء التابع <code>puts</code> دون تمرير وسائط، سيطبع سطرًا جديدًا فارغًا. | يجب أن يكون المجرى مفتوحًا وفي وضعية الكتابة. إن مرِّرت مصفوفةٌ إلى التابع <code>puts</code> كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع<nowiki/>[[Ruby/ARGF/to_s | <code>to_s</code>]] تلقائيًّا. عند استدعاء التابع <code>puts</code> دون تمرير وسائط، سيطبع سطرًا جديدًا فارغًا. | ||
لاحظ أنّ التابع <code>puts</code> يستخدم دائمًا محارف الأسطر الجديدة ولا يتأثر بفاصل سجل المخرجات (<code>\$</code>). | لاحظ أنّ التابع <code>puts</code> يستخدم دائمًا محارف الأسطر الجديدة ولا يتأثر بفاصل سجل المخرجات (<code>\$</code>). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> puts(obj, ...) → nil | <syntaxhighlight lang="ruby">puts(obj, ...) → nil | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
| سطر 22: | سطر 22: | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استخدام التابع <code>puts</code>: | مثالٌ على استخدام التابع <code>puts</code>: | ||
<syntaxhighlight lang="ruby"> $stdout.puts("this", "is", ["a", "test"]) # => | <syntaxhighlight lang="ruby">$stdout.puts("this", "is", ["a", "test"]) # => | ||
سيطبع هذا المثال بعد تنفيذه الناتج التالي: | سيطبع هذا المثال بعد تنفيذه الناتج التالي: | ||
| سطر 35: | سطر 35: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/print | <code>print</code>]]: يطبع الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code>. | * التابع<nowiki/>[[Ruby/ARGF/print | <code>print</code>]]: يطبع الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code>. | ||
* التابع [[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | * التابع<nowiki/>[[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | ||
* التابع [[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | * التابع<nowiki/>[[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | ||
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-puts قسم التابع puts في الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-puts قسم التابع puts في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 13:10، 3 أكتوبر 2018
يكتب التابع 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.