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

المراجعة الحالية بتاريخ 08:34، 11 نوفمبر 2018

يقرأ التابع read المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. عند الوصول إلى نهاية المجلد، يعيد التابع القيمة nil.

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

 read → string or nil

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

تُعاد سلسلة نصية تمثل المدخلة التالية في المجلد المعطى، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.

أمثلة

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

 d = Dir.new("testdir")
d.read   #=> "."
d.read   #=> ".."
d.read   #=> "config.h"

انظر أيضًا

التابع inspect: يعيد سلسلة نصية تصف الكائن (من صنف Dir) الذي استُدعي معه.

مصادر

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

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:  التابع <code>read</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.read</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Dir]]
-يعيد التابع <code>fileno</code> عددًا صحيحًا يمثل واصف الملف العددي (numeric  file descriptor) المُستخدم في الكائن (من صنف <code>Dir)</code> الذي استُدعي معه.
+يقرأ التابع <code>read</code> المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. عند الوصول إلى نهاية المجلد، يعيد التابع القيمة <code>nil</code>.
-هذا التابع يستخدم الدالة <code>dirfd()</code>‎ المُعرّفة في POSIX 2008. في أنظمة التشغيل التي لا توفّر هذه الدالة، مثل ويندوز، سيُطلق خطأ <code>NotImplementedError</code>.
 ==البنية العامة==
-<syntaxhighlight lang="ruby"> fileno → integer
+<syntaxhighlight lang="ruby"> read → string or nil
   </syntaxhighlight>
 ==القيم المعادة==
-يعاد عدد صحيح (integer) يمثل واصف الملف العددي (numeric  file descriptor) لمُستخدم في الكائن من صنف <code>Dir</code> الذي استُدعي معه.
+تُعاد سلسلة نصية تمثل المدخلة التالية في المجلد المعطى، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.
 ==أمثلة==
-مثالٌ على استخدام التابع <code>fileno</code>:
+مثال عن استخدام التابع <code>read</code> على المجلد <code>testdir</code> الذي يحوي ملفين عاديين (<code>config.h</code> و <code>main.rb</code>)، والمجلد الأب (<code>..</code>)، والمجلد نفسه (<code>.</code>):<syntaxhighlight lang="ruby"> d = Dir.new("testdir")
-<syntaxhighlight lang="ruby"> d = Dir.new("..")
+d.read   #=> "."
-d.fileno   #=> 8 </syntaxhighlight>
+d.read   #=> ".."
+d.read   #=> "config.h" </syntaxhighlight>
 ==انظر أيضًا==
-* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
+*التابع <code>[[Ruby/Dir/inspect|inspect]]</code>: يعيد سلسلة نصية تصف الكائن (من صنف <code>Dir</code>) الذي استُدعي معه.
-* التابع <code>[[Ruby/Dir/inspect|inspect]]</code>: يعيد التابع <code>inspect</code> سلسلة نصية تصف الكائن (من صنف <code>Dir</code>) الذي استُدعي معه.
 ==مصادر==
-* [http://ruby-doc.org/core-2.5.1/Dir.html#method-i-fileno قسم التابع fileno في الصنف Dir في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/Dir.html#method-i-read قسم التابع read في الصنف Dir في توثيق روبي الرسمي.]