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

من موسوعة حسوب
< Ruby‏ | Dir
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:  التابع <code>‎empty?‎</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude> تصنيف: Ruby تصن...'
 
ط مراجعة وتدقيق
 
(مراجعتان متوسطتان بواسطة مستخدم واحد آخر غير معروضتين)
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:  التابع <code>‎empty?‎</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude>
<noinclude>{{DISPLAYTITLE:  التابع <code>Dir.‎empty?‎</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Dir]]
[[تصنيف: Ruby Dir]]
يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة. عند استدعائه بدون تمرير وسيط، فسيغير مجلدَ العمل إلى قيمة متغير البيئة <code>HOME</code>  أو <code>LOGDIR.SystemCallError</code> (وربما <code>Errno::ENOENT</code>) إذا كان المجلد المُستهدف غير موجود.
يتحقق التابع <code>?empty</code> فيما إذا كان المجلد المعطى فارغًا.  
 
في حال إعطاء كتلة برمجية، فسيُمرّر اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. سيُستعاد مجلد العمل الأصلي عند الخروج من الكتلة. وتكون القيمة المعادة للتابع <code>chdir</code> مساوية لقيمة الكتلة.
 
يمكن أن تتشعّب كتل <code>chdir</code>، ولكن في البرامج المتفرّعة (Multi-threaded) سيُطلق خطأ إذا حاول أحد المهام الفرعية (thread)  فتح كتلة <code>chdir</code> بينما نقوم مهمة فرعية أخرى بفتح آخر.


== البنية العامة ==
== البنية العامة ==
<syntaxhighlight lang="ruby">
<syntaxhighlight lang="ruby">
chdir( [ string] ) → 0
empty?(path_name) → true or false
chdir( [ string] ) {| path | block } → anObject
</syntaxhighlight>
</syntaxhighlight>


سطر 18: سطر 13:


=== <code>string</code> ===
=== <code>string</code> ===
يحتوي هذا المعامل عنوان مجلد العمل الجديد.
يحتوي عنوان المجلد المراد التحقق منه.
 
== القيمة المٌعادة ==
في حال تمرير كتلة فالقيمة المعادة للتابع <code>chdir</code> ستساوي قيمة تلك الكتلة.


== أمثلة ==
== القيمة المعادة ==
أمثلة عن استخدام التابع <code>chdir‎</code>:<syntaxhighlight lang="ruby">
ستُعاد القيمة <code>true</code> في حال كان المجلد <code>string</code> المعطى فارغًا، وإلا فستعاد القيمة <code>false</code>.
Dir.chdir("/var/spool/mail")
puts Dir.pwd
Dir.chdir("/tmp") do
  puts Dir.pwd
  Dir.chdir("/usr") do
    puts Dir.pwd
  end
  puts Dir.pwd
end
puts Dir.pwd
</syntaxhighlight>


== أنظر أيضًا ==
== انظر أيضًا ==
* صفحة الصنف <code>[[Ruby/Dir|Dir]]</code>.
* التابع <code>[[Ruby/Dir/exist|?exist]]</code>: يتحقق فيما إذا كان الملف المعطى مجلدًا موجودًا
* التابع <code>[[Ruby/Dir/5B-5D|Dir[]]]‎</code> : يكافئ التابع <code>Dir[]‎</code> استدعاء <code>Dir.glob([string,...], 0)</code>‎


== مصادر ==
== مصادر ==
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-chdir قسم التابع chdir في الصنف Dir في توثيق روبي الرسمي.]
* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-empty-3F قسم التابع ?empty في الصنف Dir في توثيق روبي الرسمي.]

المراجعة الحالية بتاريخ 22:31، 10 نوفمبر 2018

يتحقق التابع ?empty فيما إذا كان المجلد المعطى فارغًا.

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

empty?(path_name)  true or false

المعاملات

string

يحتوي عنوان المجلد المراد التحقق منه.

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

ستُعاد القيمة true في حال كان المجلد string المعطى فارغًا، وإلا فستعاد القيمة false.

انظر أيضًا

  • التابع ?exist: يتحقق فيما إذا كان الملف المعطى مجلدًا موجودًا. 

مصادر