الفرق بين المراجعتين لصفحة: «Ruby/IO/putc»

المراجعة الحالية بتاريخ 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.

مصادر

قسم التابع putc‎ في الصنف IO‎ في توثيق روبي الرسمي.

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