التابع `chroot` الخاص بالصنف `Dir` في روبي

يستبدل التابع chdir‎ مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة. عند استدعائه بدون تمرير وسيط، فسيغير مجلدَ العمل إلى قيمة متغير البيئة HOME أو LOGDIR.SystemCallError (وربما Errno::ENOENT) إذا كان المجلد المُستهدف غير موجود.

في حال إعطاء كتلة برمجية، فسيُمرّر اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. سيُستعاد مجلد العمل الأصلي عند الخروج من الكتلة. وتكون القيمة المعادة للتابع chdir مساوية لقيمة الكتلة.

يمكن أن تتشعّب كتل chdir، ولكن في البرامج المتفرّعة (Multi-threaded) سيُطلق خطأ إذا حاول أحد المهام الفرعية (thread) فتح كتلة chdir بينما نقوم مهمة فرعية أخرى بفتح آخر.

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

chdir( [ string] ) → 0
chdir( [ string] ) {| path | block } → anObject

المعاملات

`string`

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

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

في حال تمرير كتلة فالقيمة المعادة للتابع chdir ستساوي قيمة تلك الكتلة.

أمثلة

أمثلة عن استخدام التابع chdir‎:

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

أنظر أيضًا

صفحة الصنف Dir.
التابع Dir[]‎ : يكافئ التابع Dir[]‎ استدعاء Dir.glob([string,...], 0)‎.

مصادر

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