الفرق بين المراجعتين لصفحة: «Ruby/ARGF/putc»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 5: | سطر 5: | ||
يكتب التابع <code>putc</code> محرفًا واحدًا على المجرى <code>ios</code> (اختصارًا للعبارة Input Output Stream). | يكتب التابع <code>putc</code> محرفًا واحدًا على المجرى <code>ios</code> (اختصارًا للعبارة Input Output Stream). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> putc(obj) → obj | <syntaxhighlight lang="ruby">putc(obj) → obj | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
| سطر 11: | سطر 11: | ||
=== <code>obj</code> === | === <code>obj</code> === | ||
إن كان المعامل <code>obj</code> قيمةً عدديةً، فسيكتب التابع <code>putc</code> المحرف الذي تتساوى قيمته العددية مع القيمة العددية للبايت الأقل أهمية (least-significant) من الكائن <code>obj</code> على المجرى <code>ios</code>. أمَّا إن كان المعامل <code>obj</code> سلسلةً نصيةً، فسيكتب التابع المحرف الأول من هذه السلسلة على المجرى <code>ios</code>. | إن كان المعامل <code>obj</code> قيمةً عدديةً، فسيكتب التابع <code>putc</code> المحرف الذي تتساوى قيمته العددية مع القيمة العددية للبايت الأقل أهمية (least-significant) من الكائن <code>obj</code> على المجرى <code>ios</code>. أمَّا إن كان المعامل <code>obj</code> سلسلةً نصيةً، فسيكتب التابع المحرف الأول من هذه السلسلة على المجرى <code>ios</code>. | ||
إن لم يكن <code>obj</code> سلسلةً نصيةً ولا عددًا، فسيُطلَق الخطأ <code>TypeError</code>. | إن لم يكن <code>obj</code> سلسلةً نصيةً ولا عددًا، فسيُطلَق الخطأ <code>TypeError</code>. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 16: | سطر 17: | ||
==أمثلة== | ==أمثلة== | ||
مثالٌ على استخدام التابع <code>putc</code>: | مثالٌ على استخدام التابع <code>putc</code>: | ||
<syntaxhighlight lang="ruby"> $stdout.putc "A" | <syntaxhighlight lang="ruby">$stdout.putc "A" | ||
$stdout.putc 65 | $stdout.putc 65 | ||
سيطبع هذا المثال بعد تنفيذه الناتج التالي: | سيطبع هذا المثال بعد تنفيذه الناتج التالي: | ||
| سطر 22: | سطر 23: | ||
</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/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | * التابع<nowiki/>[[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | ||
* التابع [[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-putc قسم التابع putc في الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-putc قسم التابع putc في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 13:10، 3 أكتوبر 2018
يكتب التابع putc محرفًا واحدًا على المجرى ios (اختصارًا للعبارة Input Output Stream).
البنية العامة
putc(obj) → obj
المعاملات
obj
إن كان المعامل obj قيمةً عدديةً، فسيكتب التابع putc المحرف الذي تتساوى قيمته العددية مع القيمة العددية للبايت الأقل أهمية (least-significant) من الكائن obj على المجرى ios. أمَّا إن كان المعامل obj سلسلةً نصيةً، فسيكتب التابع المحرف الأول من هذه السلسلة على المجرى ios.
إن لم يكن obj سلسلةً نصيةً ولا عددًا، فسيُطلَق الخطأ TypeError.
القيم المعادة
يعاد الكائن obj المعطى بعد كتابته على المجرى ios.
أمثلة
مثالٌ على استخدام التابع putc:
$stdout.putc "A"
$stdout.putc 65
سيطبع هذا المثال بعد تنفيذه الناتج التالي:
AA
انظر أيضًا
- التابع
print: يطبع الكائن أو الكائنات المُمرَّرة إليه على المجرىios. - التابع
printf: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرىiosبعد تنسيقها بشكل معين. - التابع
puts: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرىiosثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. - التابع
getc: يجلب المحرف التالي من المجرىARGF. - التابع
readchar: يقرأ المحرف التالي من المجرىARGFثم يعيده على شكل سلسلة نصية.