الفرق بين المراجعتين لصفحة: «Ruby/IO/puts»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يكتب التابع <code>puts</code> الكائن(ات) | يكتب التابع <code>puts</code> الكائن(ات) المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة <code>nil</code>. يجب أن يكون المجرى مفتوحًا في وضعية الكتابة. | ||
إن كان | إن كان الكائن المعطى [[Ruby/Array|مصفوفةً]]، فسيكتب التابع <code>puts</code> كل عنصر من عناصرها في سطر جديد. | ||
إن لم يكن الكائن [[Ruby/String|سلسلة نصية]] أو [[Ruby/Array|مصفوفة]] فسيتم تحويله عن طريق استدعاء تابعه <code>to_s</code>. | إن لم يكن الكائن [[Ruby/String|سلسلة نصية]] أو [[Ruby/Array|مصفوفة]]، فسيتم تحويله إلى سلسلة نصية عن طريق استدعاء تابعه <code>to_s</code>. | ||
في حال استدعاء التابع <code>puts</code> بدون | في حال استدعاء التابع <code>puts</code> بدون تمرير أي شيء إليه، فسيكتب سطرًا جديدًا واحدًا في المجرى. | ||
لاحظ | لاحظ أنَّ <code>puts</code> يستخدم دائمًا الأسطر الجديدة، ولا يتأثر بفاصل سجل الإخراج (<code>$\</code>). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">puts(obj, ...) → nil</syntaxhighlight> | <syntaxhighlight lang="ruby">puts(obj, ...) → nil</syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
===<code>obj</code>=== | ===<code>obj</code>=== | ||
[[Ruby/String|سلسلة نصية]] أو [[Ruby/Array|مصفوفة]] يراد كتابة محتواها في المجرى المعطى. | |||
<code>...</code> | |||
الكائنات الأخرى المراد كتابة محتواها ضمن المجرى المعطى. | |||
==القيمة المعادة== | |||
تعاد القيمة <code>nil</code> بعد تنفيذ العملية. | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>puts</code>: | مثال على استخدام التابع <code>puts</code>: | ||
<syntaxhighlight lang="ruby">$stdout.puts("this", "is", ["a", "test"])</syntaxhighlight>الناتج:<syntaxhighlight lang=" | <syntaxhighlight lang="ruby">$stdout.puts("this", "is", ["a", "test"])</syntaxhighlight>الناتج:<syntaxhighlight lang="text">this | ||
is | is | ||
a | a | ||
test</syntaxhighlight> | test</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* | * التابع [[Ruby/IO/print|<code>print</code>]]: يكتب الكائن (أو الكائنات) المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استدعي معه ثم يُعيد القيمة <code>nil</code>. | ||
* التابع <code>[[Ruby/IO/putc|putc]]</code>: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-puts قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-puts قسم التابع puts في الصنف IO في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:10، 23 ديسمبر 2018
يكتب التابع 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: يكتب المحرف المُمرَّر إليه في المجرى الذي استدعي معه.