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

من موسوعة حسوب
< Ruby‏ | Dir
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:  التابع <code>read</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Rub...')
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Dir]]
 
[[تصنيف: Ruby Dir]]
يعيد التابع <code>fileno</code> عددًا صحيحًا يمثل واصف الملف العددي (numeric  file descriptor) المُستخدم في الكائن (من صنف <code>Dir)</code> الذي استُدعي معه.
+
يقرأ التابع <code>read</code> المدخل الموالي في الكائن المجلدي (''dir'' object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمة <code>nil</code> .
 
 
هذا التابع يستخدم الدالة <code>dirfd()</code>‎ المُعرّفة في POSIX 2008. في أنظمة التشغيل التي لا توفّر هذه الدالة، مثل ويندوز، سيُطلق خطأ <code>NotImplementedError</code>.
 
 
==البنية العامة==
 
==البنية العامة==
<syntaxhighlight lang="ruby"> fileno integer
+
<syntaxhighlight lang="ruby"> read string or nil
 
  </syntaxhighlight>
 
  </syntaxhighlight>
 
==القيم المعادة==
 
==القيم المعادة==
يعاد عدد صحيح (integer) يمثل واصف الملف العددي (numeric file descriptor) لمُستخدم في الكائن من صنف <code>Dir</code> الذي استُدعي معه.
+
التابع <code>read</code> يعيد سلسلة نصية تمثل المدخل الموالي في الكائن المجلدي (''dir'' object) الذي استُدعي معه. وفي نهاية المجرى يعيد القيمة <code>nil</code>.
 
==أمثلة==
 
==أمثلة==
مثالٌ على استخدام التابع <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("..")
+
<syntaxhighlight lang="ruby"> d = Dir.new("testdir")
d.fileno   #=> 8 </syntaxhighlight>
+
d.read  #=> "."
 +
d.read  #=> ".."
 +
d.read   #=> "config.h" </syntaxhighlight>
 
==انظر أيضًا==
 
==انظر أيضًا==
 
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
 
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
سطر 20: سطر 20:
  
 
==مصادر==
 
==مصادر==
* [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 في توثيق روبي الرسمي.]

مراجعة 17:32، 24 سبتمبر 2018

يقرأ التابع read المدخل الموالي في الكائن المجلدي (dir object) الذي استُدعي معه ثم يعيده على شكل سلسلة نصية. وفي نهاية المجرى يعيد القيمة nil .

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

 read  string or nil

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

التابع read يعيد سلسلة نصية تمثل المدخل الموالي في الكائن المجلدي (dir object) الذي استُدعي معه. وفي نهاية المجرى يعيد القيمة nil.

أمثلة

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

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

انظر أيضًا

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

مصادر