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

من موسوعة حسوب
< Ruby‏ | Dir
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>delete</code> الخاص بالصنف <code>Dir</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ru...'
 
لا ملخص تعديل
سطر 3: سطر 3:
[[تصنيف: 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>delete‎</code> المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من <code>SystemCallError</code>  في حال لم يكن المجلد موجودًا.  
 
في حال إعطاء كتلة برمجية، فسيُمرّر اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. سيُستعاد مجلد العمل الأصلي عند الخروج من الكتلة. وتكون القيمة المعادة للتابع <code>chdir</code> مساوية لقيمة الكتلة.
 
يمكن أن تتشعّب كتل <code>chdir</code>، ولكن في البرامج المتفرّعة (Multi-threaded) سيُطلق خطأ إذا حاول أحد المهام الفرعية (thread)  فتح كتلة <code>chdir</code> بينما نقوم مهمة فرعية أخرى بفتح آخر.


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


سطر 18: سطر 13:


=== <code>string</code> ===
=== <code>string</code> ===
يحتوي هذا المعامل عنوان مجلد العمل الجديد.
اسم المجلد المُراد حذفه.
 
== القيمة المٌعادة ==
في حال تمرير كتلة فالقيمة المعادة للتابع <code>chdir</code> ستساوي قيمة تلك الكتلة.
 
== أمثلة ==
أمثلة عن استخدام التابع <code>chdir‎</code>:<syntaxhighlight lang="ruby">
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|Dir]]</code>.
* التابع <code>[[Ruby/Dir/5B-5D|Dir[]]]‎</code> : يكافئ التابع <code>Dir[]‎</code> استدعاء <code>Dir.glob([string,...], 0)</code>. 
 
* التابع <code>[[Ruby/Dir/chdir|chdir]]‎</code> : يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
* التابع <code>[[Ruby/Dir/chdir|chroot]]‎</code> : يغير التابع <code>chroot</code> جذر (root) نظام الملفات الخاص بالعملية (process). فقط العمليات ذات الامتياز (privileged process) مُخوّلة لاستدعاء هذا التابع.


== مصادر ==
== مصادر ==
* [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-delete قسم  التابع delete في الصنف Dir في توثيق روبي الرسمي.]

مراجعة 18:04، 22 سبتمبر 2018

يمحو التابع delete‎ المجلد المحدد، سيُطلق خطأ من صنف فرعي (subclass) من SystemCallError  في حال لم يكن المجلد موجودًا.

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

delete( string )  0

المعاملات

string

اسم المجلد المُراد حذفه.

أنظر أيضًا

  • صفحة الصنف Dir.
  • التابع chdir : يستبدل التابع chdir‎ مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة.
  • التابع chroot : يغير التابع chroot جذر (root) نظام الملفات الخاص بالعملية (process). فقط العمليات ذات الامتياز (privileged process) مُخوّلة لاستدعاء هذا التابع.

مصادر