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

المراجعة الحالية بتاريخ 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: ينفذ الكتلة المعطاة على كل سطر في المجرى الذي استدعي معه.

مصادر

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

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