الفرق بين المراجعتين ل"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|المجرى]] الذي استدعي معه. |
| − | في حال لم | + | يجب أن يكون [[Ruby/IO|المجرى]] مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء <code>[[Ruby/IOError|IOError]]</code>. |
| + | |||
| + | في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف <code>[[Ruby/Enumerator|Enumerator]]</code> بدلًا من ذلك. | ||
==البنية العامة== | ==البنية العامة== | ||
<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> | ||
| − | ==القيمة | + | ==القيمة المعادة== |
| + | يعاد [[Ruby/IO|المجرى]] المعطى بعد تنفيذ الكتلة <code>block</code> على كل محرف من محارفه، أو يعاد كائن من الصنف <code>[[Ruby/Enumerator|Enumerator]]</code> في حال لم تُعطَ أية كتلة. | ||
==أمثلة== | ==أمثلة== | ||
مثال على استخدام التابع <code>each_char</code>: | مثال على استخدام التابع <code>each_char</code>: | ||
<syntaxhighlight lang="ruby">f = File.new("testfile") | <syntaxhighlight lang="ruby">f = File.new("testfile") | ||
f.each_char {|c| print c, ' ' } #=> #<File:testfile></syntaxhighlight> | f.each_char {|c| print c, ' ' } #=> #<File:testfile></syntaxhighlight> | ||
| − | ==انظر | + | ==انظر أيضًا== |
| − | * التابع <code>[[Ruby/IO/ | + | *التابع <code>[[Ruby/IO/each|each]]</code>: ينفذ الكتلة المعطاة على كل سطر في [[Ruby/IO|المجرى]] الذي استُدعي معه. |
| − | * التابع <code>[[Ruby/IO/ | + | *التابع <code>[[Ruby/IO/each byte|each_byte]]</code>: يستدعي الكتلة المعطاة على كل بايت (0..255) في [[Ruby/IO|المجرى]] الذي استدعي معه. |
| + | *التابع <code>[[Ruby/IO/each codepoint|each_codepoint]]</code>: يمرر كل عدد من الأعداد الترتيبية (Integer ordinal) لكل محرف من المحارف الموجودة في [[Ruby/IO|المجرى]] الذي استدعي معه إلى الكتلة المعطاة. | ||
| + | *التابع [[Ruby/IO/each line|<code>each_line</code>]]: ينفذ الكتلة المعطاة على كل سطر في [[Ruby/IO|المجرى]] الذي استدعي معه. | ||
==مصادر== | ==مصادر== | ||
| − | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-each_char قسم | + | *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-each_char قسم التابع each_char في الصنف IO في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 09:26، 22 ديسمبر 2018
يستدعي التابع each_char الكتلة المعطاة على كل محرف في المجرى الذي استدعي معه.
يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError.
في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك.
البنية العامة
each_char {|c| block } → ios
each_char→ an_enumerator
القيمة المعادة
يعاد المجرى المعطى بعد تنفيذ الكتلة block على كل محرف من محارفه، أو يعاد كائن من الصنف Enumerator في حال لم تُعطَ أية كتلة.
أمثلة
مثال على استخدام التابع each_char:
f = File.new("testfile")
f.each_char {|c| print c, ' ' } #=> #<File:testfile>
انظر أيضًا
- التابع
each: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استُدعي معه. - التابع
each_byte: يستدعي الكتلة المعطاة على كل بايت (0..255) في المجرى الذي استدعي معه. - التابع
each_codepoint: يمرر كل عدد من الأعداد الترتيبية (Integer ordinal) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة. - التابع
each_line: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه.