الفرق بين المراجعتين لصفحة: «Ruby/ARGF/puts»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.puts</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby ARGF...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يكتب التابع <code>puts</code> الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> (اختصارًا للعبارة | يكتب التابع <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> كوسيط، فسيطبع كلَّ عنصر في سطر جديد. إن لم يكن الكائن المعطى سلسلةً نصيةً أو مصفوفة، فسيُحوَل إلى سلسلة نصية باستدعاء التابع [[Ruby/ARGF/to_s | <code>to_s</code>]] تلقائيًّا. عند استدعاء التابع <code>puts</code> دون تمرير وسائط، سيطبع سطرًا جديدًا فارغًا. | ||
لاحظ أنّ التابع <code>puts</code> يستخدم دائمًا محارف الأسطر الجديدة ولا يتأثر بفاصل سجل المخرجات (\$). | |||
لاحظ أنّ التابع <code>puts</code> يستخدم دائمًا محارف الأسطر الجديدة ولا يتأثر بفاصل سجل المخرجات (<code>\$</code>). | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> puts(obj, ...) → nil | <syntaxhighlight lang="ruby"> puts(obj, ...) → nil | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>obj</code> | |||
=== <code>obj</code> === | |||
الكائن المراد كتابته على المجرى <code>ios</code>. | الكائن المراد كتابته على المجرى <code>ios</code>. | ||
… | |||
=== <code>…</code> === | |||
الكائنات الأخرى المراد كتابتها على المجرى <code>ios</code>. | الكائنات الأخرى المراد كتابتها على المجرى <code>ios</code>. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 34: | سطر 38: | ||
* التابع [[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | * التابع [[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | ||
* التابع [[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | * التابع [[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | ||
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى | * التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى | * التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع puts في الصنف ARGF في توثيق روبي الرسمي. | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-puts قسم التابع puts في الصنف ARGF في توثيق روبي الرسمي.] | ||
مراجعة 17:54، 10 سبتمبر 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.