الفرق بين المراجعتين لصفحة: «Ruby/ARGF/putc»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.putc</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby ARGF...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يكتب التابع <code>putc</code> محرفًا واحدًا على المجرى <code>ios</code> (اختصارًا للعبارة | يكتب التابع <code>putc</code> محرفًا واحدًا على المجرى <code>ios</code> (اختصارًا للعبارة Input Output Stream). | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> putc(obj) → obj | <syntaxhighlight lang="ruby"> putc(obj) → obj | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>obj</code> | |||
إن كان المعامل <code>obj</code> قيمةً عدديةً، فسيكتب التابع <code>putc</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>TypeError</code>. | إن لم يكن <code>obj</code> سلسلةً نصيةً ولا عددًا، فسيُطلَق الخطأ <code>TypeError</code>. | ||
==القيم المعادة== | ==القيم المعادة== | ||
| سطر 24: | سطر 25: | ||
* التابع [[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | * التابع [[Ruby/ARGF/printf | <code>printf</code>]]: يطبع الكائن أو الكائنات الممرَّرة إليه على المجرى <code>ios</code> بعد تنسيقها بشكل معين. | ||
* التابع [[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | * التابع [[Ruby/ARGF/puts | <code>puts</code>]]: يكتب الكائن أو الكائنات المُمرَّرة إليه على المجرى <code>ios</code> ثمَّ يضيف سطرًا جديدًا في النهاية إن لم تحتوِ تلك الكائنات المعطاة على محرف سطرٍ جديدٍ. | ||
* التابع [[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى | * التابع [[Ruby/ARGF/getc | <code>getc</code>]]: يجلب المحرف التالي من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى | * التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع putc في الصنف ARGF في توثيق روبي الرسمي. | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-putc قسم التابع putc في الصنف ARGF في توثيق روبي الرسمي.] | ||
مراجعة 17:52، 10 سبتمبر 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ثم يعيده على شكل سلسلة نصية.