الفرق بين المراجعتين لصفحة: «Ruby/IO/putc»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط تدقيق |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يكتب التابع <code>putc</code> المحرف المُمرَّر إليه في [[Ruby/IO|المجرى]] الذي استدعي معه. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">putc(obj) → obj</syntaxhighlight> | <syntaxhighlight lang="ruby">putc(obj) → obj</syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
===<code> | ===<code>obj</code>=== | ||
كائن | كائن يحوي المحرف المراد كتابته على المجرى المعطى. إن كان هذا الكائن عددًا، فسيُكتَب المحرف الذي رمزه هو قيمة البايت الأقل أهمية (least-significant byte). أما إن كان <code>obj</code> [[Ruby/String|سلسلةً نصيةً]]، فسيُكتَب أول محرف من محارف هذه السلسلة في [[Ruby/IO|المجرى]]. خلاف ذلك، سيُطلق الاستثناء <code>[[Ruby/TypeError|TypeError]]</code>. | ||
==القيمة | ==القيمة المعادة== | ||
يعاد المعامل <code>obj</code> بعد كتابته على المجرى المعطى. | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>putc</code>: | مثال على استخدام التابع <code>putc</code>: | ||
<syntaxhighlight lang="ruby">$stdout.putc "A" | <syntaxhighlight lang="ruby">$stdout.putc "A" | ||
$stdout.putc 65</syntaxhighlight>الناتج:<syntaxhighlight lang=" | $stdout.putc 65</syntaxhighlight>الناتج:<syntaxhighlight lang="text">AA | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/IO/printf|printf]]</code>: ينسق | * التابع <code>[[Ruby/IO/printf|printf]]</code>: ينسق الكائنات المُمرَّرة إليه ثم يكتبها في [[Ruby/IO|المجرى]] الذي استدعي معه. | ||
* التابع <code>[[Ruby/IO/puts|puts]]</code>: يكتب | * التابع <code>[[Ruby/IO/puts|puts]]</code>: يكتب الكائن(ات) المُمرَّرة إليه في [[Ruby/IO|المجرى]] الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمة <code>nil</code>. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-putc قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-putc قسم التابع putc في الصنف IO في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 07:08، 23 ديسمبر 2018
يكتب التابع putc المحرف المُمرَّر إليه في المجرى الذي استدعي معه.
البنية العامة
putc(obj) → obj
المعاملات
obj
كائن يحوي المحرف المراد كتابته على المجرى المعطى. إن كان هذا الكائن عددًا، فسيُكتَب المحرف الذي رمزه هو قيمة البايت الأقل أهمية (least-significant byte). أما إن كان obj سلسلةً نصيةً، فسيُكتَب أول محرف من محارف هذه السلسلة في المجرى. خلاف ذلك، سيُطلق الاستثناء TypeError.
القيمة المعادة
يعاد المعامل obj بعد كتابته على المجرى المعطى.
أمثلة
مثال على استخدام التابع putc:
$stdout.putc "A"
$stdout.putc 65
الناتج:
AA
انظر أيضًا
- التابع
printf: ينسق الكائنات المُمرَّرة إليه ثم يكتبها في المجرى الذي استدعي معه. - التابع
puts: يكتب الكائن(ات) المُمرَّرة إليه في المجرى الذي استُدعي معه، ويضيف سطرًا جديدًا بعد الأسطر التي لا تنتهي بمحرف السطر الجديد ثم يعيد القيمةnil.