الفرق بين المراجعتين لصفحة: «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>. | ||
==القيم المعادة== | ==القيم المعادة== | ||
سطر 15: | سطر 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 | ||
سيطبع هذا المثال بعد تنفيذه الناتج التالي: | سيطبع هذا المثال بعد تنفيذه الناتج التالي: | ||
سطر 21: | سطر 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> ثم يعيده على شكل سلسلة نصية. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع 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
ثم يعيده على شكل سلسلة نصية.