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