الفرق بين المراجعتين لصفحة: «Ruby/IO/each char»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>IO.each_char</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Rub...' |
لا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يستدعي التابع <code>each_char</code> الكتلة المعطاةة | يستدعي التابع <code>each_char</code> الكتلة المعطاةة على كل حرف في [[Ruby/IO|مجرى د/خ]]، مع تمرير الحرف كوسيط. | ||
في حال لم تُعطى أي كتلة، فسيُعاد كائن من الصنف | يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُرفع استثناء <code>IOError</code>. | ||
في حال لم تُعطى أي كتلة، فسيُعاد كائن من الصنف [[Ruby/Enumerator|Enumerator]] بدلاً من ذلك. | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">each_char {|c| block } → ios | <syntaxhighlight lang="ruby">each_char {|c| block } → ios | ||
each_char→ an_enumerator</syntaxhighlight> | each_char→ an_enumerator</syntaxhighlight> | ||
==القيمة المُعادة== | ==القيمة المُعادة== | ||
يعيد التابع <code>each_char</code> [[Ruby/IO|مجرى د/خ]] الذي استُدعي معه، وفي حال لم تُعطى أي كتلة، فسيُعاد كائن من الصنف <code>[[Ruby/Enumerator|Enumerator]]</code> | |||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>each_char</code>: | مثال على استخدام التابع <code>each_char</code>: | ||
| سطر 15: | سطر 19: | ||
f.each_char {|c| print c, ' ' } #=> #<File:testfile></syntaxhighlight> | f.each_char {|c| print c, ' ' } #=> #<File:testfile></syntaxhighlight> | ||
==انظر أيضا== | ==انظر أيضا== | ||
* التابع <code>[[Ruby/IO/each_byte|each_byte]]</code>: يستدعي الكتلة المعطاة مرة | * التابع <code>[[Ruby/IO/each_byte|each_byte]]</code>: يستدعي الكتلة المعطاة مرة على بايت (0..255) في [[Ruby/IO|مجرى د/خ]] | ||
* التابع <code>[[Ruby/IO/each_codepoint|each_codepoint]]</code>: يمرر | * التابع <code>[[Ruby/IO/each_codepoint|each_codepoint]]</code>: يمرر الرمز العددي الخاص بكل حرف في [[Ruby/IO|مجرى د/خ]] إلى الكتلة | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-i-each_char قسم التابع each_char في الصنف IO في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-each_char قسم التابع each_char في الصنف IO في توثيق روبي الرسمي.] | ||
مراجعة 12:43، 13 نوفمبر 2018
يستدعي التابع each_char الكتلة المعطاةة على كل حرف في مجرى د/خ، مع تمرير الحرف كوسيط.
يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُرفع استثناء IOError.
في حال لم تُعطى أي كتلة، فسيُعاد كائن من الصنف Enumerator بدلاً من ذلك.
البنية العامة
each_char {|c| block } → ios
each_char→ an_enumerator
القيمة المُعادة
يعيد التابع each_char مجرى د/خ الذي استُدعي معه، وفي حال لم تُعطى أي كتلة، فسيُعاد كائن من الصنف Enumerator
أمثلة
مثال على استخدام التابع each_char:
f = File.new("testfile")
f.each_char {|c| print c, ' ' } #=> #<File:testfile>
انظر أيضا
- التابع
each_byte: يستدعي الكتلة المعطاة مرة على بايت (0..255) في مجرى د/خ - التابع
each_codepoint: يمرر الرمز العددي الخاص بكل حرف في مجرى د/خ إلى الكتلة