الفرق بين المراجعتين ل"Ruby/Dir/read"

من موسوعة حسوب
< Ruby‏ | Dir
اذهب إلى التنقل اذهب إلى البحث
ط (مراجعة وتدقيق)
 
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:  التابع <code>read</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
+
<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.read</code> في روبي}}</noinclude>
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Dir]]
 
[[تصنيف: Ruby Dir]]
يقرأ التابع <code>read</code> المدخل الموالي في الكائن المجلدي (''dir'' object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمة <code>nil</code> .
+
يقرأ التابع <code>read</code> المدخلة التالية في المجلد الذي استُدعي معه ثم يعيده في سلسلة نصية. عند الوصول إلى نهاية المجلد، يعيد التابع القيمة <code>nil</code>.
 
==البنية العامة==
 
==البنية العامة==
 
<syntaxhighlight lang="ruby"> read → string or nil
 
<syntaxhighlight lang="ruby"> read → string or nil
 
  </syntaxhighlight>
 
  </syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
التابع <code>read</code> يعيد  سلسلة نصية تمثل المدخل الموالي في الكائن المجلدي (''dir'' object) الذي استُدعي معه. وفي نهاية المجرى يعيد القيمة <code>nil</code>.
+
تُعاد سلسلة نصية تمثل المدخلة التالية في المجلد المعطى، أو تعاد القيمة nil عند الوصول إلى نهاية المجرى.
 
==أمثلة==
 
==أمثلة==
مثال عن استخدام التابع <code>read</code> على المجلد <code>testdir</code> الذي يحتوي ملفين عاديين (<code>config.h</code> و <code>main.rb</code>) ، والمجلد الأب (<code>..</code>) ، والمجلد نفسه (<code>.</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("testdir")
 
 
d.read  #=> "."
 
d.read  #=> "."
 
d.read  #=> ".."
 
d.read  #=> ".."
 
d.read  #=> "config.h" </syntaxhighlight>
 
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-read قسم التابع read في الصنف Dir في توثيق روبي الرسمي.]
+
*[http://ruby-doc.org/core-2.5.1/Dir.html#method-i-read قسم التابع read في الصنف Dir في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 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) الذي استُدعي معه.

مصادر