الفرق بين المراجعتين ل"Ruby/IO/putc"

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.putc‎</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method [[تصنيف: Ruby IO]...')
 
ط (تدقيق)
 
(مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة)
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: 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>
 
<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>:
 
مثال على استخدام التابع <code>putc‎</code>:
 
<syntaxhighlight lang="ruby">$stdout.putc "A"
 
<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‎ في توثيق روبي الرسمي.]

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

مصادر