نتائج البحث

يعيد التابع peek_values مصفوفة تحوي القيمة التالية في المُعدِّد الذي استدعي معه بشكل مشابه للتابع next_values ولكن لا يحرِّك موضع المؤشر الداخلي للأمام. إن كان المؤشر موجود مسبقًا في النهاية، فسيُطلَق الاستثناء StopIteration.  البنية العامة peek_values → array القيمة المعادة تعاد مصفوفة تحوي القيمة التالية في المُعدِّد المعطى. أمثلة مثال على استعمال التابع peek_values: o = Object.new def o.each yield yield 1 yield 1, 2 end e = o.to_enum p e.peek_values #=> [] e.next p e.peek_values #=> [1] p ...

يمرر التابع each_codepoint كل عدد من الأعداد الترتيبية (Integer ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) لكل محرف من المحارف الموجودة في المجرى الذي استدعي معه إلى الكتلة المعطاة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة، وإلا سيُطلق الاستثناء IOError. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلًا من ذلك. البنية العامة each_codepoint {|c| block } → ios codepoints {|c| block } → ios each_codepoint→ an_enumerator codepoints → an_enumerator‎ ...

يمرِّر التابع each_grapheme_cluster كل وحدة كتابية (grapheme) إلى الكتلة المعطاة ثم يعيد سلسلة نصية بالناتج الذي تعيده. إن لم تُعطَ أية كتلة، فسيُعاد كائنٌ من النوع Enumerator. بخلاف التابع each_char، هذا التابع يكرِّر العملية على كل الوحدات الكتابية (grapheme clusters) المُعرَّفة في ترميز اليونيكود Annex #29 القياسي. البنية العامة each_grapheme_cluster {|cstr| block } → str each_grapheme_cluster → an_enumerator القيمة المعادة يعاد الناتج الذي تعيده الكتلة block بعد تمرير كل وحدة كتابية من السلسلة النصية المعطاة إليها، أو يعاد كائن من النوع ...

يستدعي التابع cycle الكتلة المعطاة مع كل عنصر من عناصر المُعدِّد الذي استدعي معه عددًا محدَّدًا من المرات أو إلى ما لانهاية إن مُرِّرت القيمة nil إليه أو لم يمُرَّر أي شيء. إن مُرِّر إلى التابع عدد غير موجب أو كانت المجموعة (المُعدِّد) المعطاة فارغةً، فلن يفعل التابع أي شيء. يحتفظ التابع cycle بالعناصر في مصفوفة داخلية، لذا لن يكون لتغيير المُعدِّد بعد تمرير أول عنصر منه أي تأثير. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا من النوع Enumerator. البنية العامة ...

يكرر التابع step تنفيذ الكتلة المعطاة ويمرر إليها n عنصرًا من عناصر المجال بالتتابع. إن كان عنصرا البداية والنهاية عددين، فسيضاف n عند كل تكرار. وإلا، فإن التابع step سيستدعي succ للتكرار على عناصر المجال. في حال لم تُعطَ أية كتلة، فسيُعاد كائن من الصنف Enumerator بدلاً من ذلك. البنية العامة step(n=1) {| obj | block } → rng step(n=1)→ an_enumerator‎ المعاملات n‎ عدد صحيح يمثِّل الخطوة. الخطوة الافتراضية هي: 1. القيمة المعادة يعاد مجالٌ، أو كائن من الصنف Enumerator في حال ...

يستدعي التابع foreach الكتلة المعطاة على كل ملف من الملفات الموجودة في المجلد المحدد، إذ يمُمرّر أسماء تلك الملفات كوسائط للكتلة. في حال عدم تمرير أي كتلة، يعاد كائنٌ من النوع enumerator. البنية العامة foreach( dirname ) {| filename | block } → nil foreach( dirname, encoding: enc ) {| filename | block } → nil foreach( dirname ) → an_enumerator foreach( dirname, encoding: enc ) → an_enumerator المعاملات dirname اسم المجلد المعطى المراد تنفيذ الكتلة block على كل عنصر من عناصره. encoding ...

يقطِّع التابع slice_before عناصر الكائن القابل للتعداد إلى أجزاء تحدَّد بدايتها عبر نمطٍ محدِّدٍ أو كتلةٍ معطاةٍ ثم يعيد مُعدِّد لكل جزء من الأجزاء الناتجة. البنية العامة slice_before(pattern) → an_enumerator slice_before { |elt| bool } → an_enumerator إن كان النمط مطابقًا للعنصر (أي يعيد pattern === elt القيمة true) أو أعادت الكتلة القيمة true للعنصر المُمرَّر إليها، فسيُعدُّ العنصر بدايةً لجزء. يُستدعَى المعامل === والكتلة block من أول عنصر وحتى آخر عنصر من عناصر الكائن القابل للتعداد المعطى. يجري دومًا تجاهل النتيجة ...

ينشئ التابع chunk_while مُعدِّدًا لكل جزء من العناصر المجمَّعة سويةً. تُعرَّف بداية الأجزاء (chunks) عبر الكتلة المعطاة. البنية العامة chunk_while {|elt_before, elt_after| bool } → an_enumerator يفصل هذا التابع كل جزء باستعمال العناصر المتجاورة، التي هي elt_before و elt_after، في المُعدِّد المستقبل. يفصل هذا التابع الأجزاء بين elt_before و elt_after حيث تعيد الكتلة القيمة false. تُستدعَى الكتلة مع طول المُعدِّد المستقبل مطروحًا منه الواحد. ينتج عن المُعدِّد الناتج العناصر المجمَّعة كمصفوفة. لذلك، يمكن استدعاء التابع each بالشكل التالي: enum.chunk_while { |elt_before, elt_after| bool ...

يستدعي التابع each_child الكتلة المعطاة على كل ملف أو مجلد موجود في المجلد المحدد باستثناء ".." و "." إذ يمُمرّر أسماء تلك الملفات كوسائط إلى الكتلة. في حال عدم تمرير أي كتلة، يعاد كائنٌ من النوع enumerator. البنية العامة each_child( dirname ) {| filename | block } → nil click to toggle source each_child( dirname, encoding: enc ) {| filename | block } → nil each_child( dirname ) → an_enumerator each_child( dirname, encoding: enc ) → an_enumerator المعاملات dirname اسم المجلد المراد تنفيذ ...

يُمرر التابع each_codepoint كل عدد من الأعداد الترتيبية (Integers ordinal، وتُعرف أيضًا باسم "نقاط الترميز" [codepoints] في السلاسل النصية المرمزة بالترميز الموحد [Unicode]) المقابلة لكل محرف من محارف السلسلة النصية المعطاة إلى الكتلة المرتبطة به ثم يعيد الناتج الذي تعيده هذه الكتلة. إذا كان ترميز السلسلة غير الترميزات التالية: UTF-8، أو (UTF-16(BE|LE، أو (UTF-32(BE|LE، فإن القيم تُؤخذ مباشرةً من الترميز الثنائي لكل محرف. في حال عدم وجود كتلة، فسيعيد التابع كائنًا من النوع enumerator. البنية العامة each_codepoint {|integer| block } ...