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

مراجعة 10:07، 24 سبتمبر 2018

يستدعي التابع foreach الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.

في حال عدم تمرير أي كتلة، فسيعاد كائن من النوع enumerator.

البنية العامة

foreach( dirname ) {| filename | block } → nil click to toggle source
foreach( dirname, encoding: enc ) {| filename | block } → nil
foreach( dirname ) → an_enumerator
foreach( dirname, encoding: enc ) → an_enumerator

المعاملات

`dirname`

يحدد اسم المجلد المعطى.

`encoding`

يحدد ترميز المجلد المعطى.

القيمة المٌعادة

في حال تمرير كتلة فالقيمة المعادة للتابع chdir ستكون nil، وإلا فسيعاد كائن من النوع enumerator.

أمثلة

مثال عن استخدام التابع foreach على المجلد testdir الذي يحتوي ملفين عاديين (config.h و main.rb) ، والمجلد الأب (..) ، والمجلد نفسه (.).

Dir.foreach("testdir") {|x| puts "Got #{x}" }

سينتج:

Got .
Got ..
Got config.h
Got main.rb

أنظر أيضًا

التابع each: يستدعي التابع each الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
التابع each_child : يستدعي التابع each_child الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد باستثناء ".." و ".". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.

مصادر

قسم التابع foreach في الصنف Dir في توثيق روبي الرسمي.

@@ سطر 38: / سطر 38: @@
 == أنظر أيضًا ==
-* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
+* التابع <code>[[Ruby/Dir/each|each]]</code>: يستدعي التابع <code>each</code> الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد. حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
 * التابع <code>[[Ruby/Dir/each child|each_child]]</code> : يستدعي التابع <code>each_child</code> الكتلة المعطاة على كل ملف من الملفات المحتواة في المجلد المحدد باستثناء "<code>..</code>" و "<code>.</code>". حيث يمُمرّر أسماء تلك الملفات كوسائط للكتلة.
 == مصادر ==
 * [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-foreach قسم  التابع foreach في الصنف Dir في توثيق روبي الرسمي.]