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

مراجعة 10:12، 18 سبتمبر 2018

يستبدل التابع 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 في توثيق روبي الرسمي.

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby Dir]]
-يكافئ التابع <code>Dir[]‎</code> استدعاء <code>Dir.glob([string,...], 0)</code>‎.
+يستبدل التابع <code>chdir‎</code> مجلد العمل (working directory) الحالي للعملية ويعيّن مكانه السلسلة النصية المعطاة. عند استدعائه بدون تمرير وسيط، فسيغير مجلدَ العمل إلى قيمة متغير البيئة <code>HOME</code>  أو <code>LOGDIR.SystemCallError</code> (وربما <code>Errno::ENOENT</code>) إذا كان المجلد المُستهدف غير موجود.
+في حال إعطاء كتلة برمجية، فسيُمرّر اسم المجلد الحالي الجديد، وستنفّذ الكتلة على اعتباره المجلد الحالي. سيُستعاد مجلد العمل الأصلي عند الخروج من الكتلة. وتكون القيمة المعادة للتابع <code>chdir</code> مساوية لقيمة الكتلة.
+يمكن أن تتشعّب كتل <code>chdir</code>، ولكن في البرامج المتفرّعة (Multi-threaded) سيُطلق خطأ إذا حاول أحد المهام الفرعية (thread)  فتح كتلة <code>chdir</code> بينما نقوم مهمة فرعية أخرى بفتح آخر.
 == البنية العامة ==
 <syntaxhighlight lang="ruby">
-Dir[ string [, string ...] [, base: path] ] → array
+chdir( [ string] ) → 0
+chdir( [ string] ) {| path | block } → anObject
 </syntaxhighlight>
+== المعاملات ==
+=== <code>string</code> ===
+يحتوي هذا المعامل عنوان مجلد العمل الجديد.
 == القيمة المٌعادة ==
-يعيد  التابع <code>Dir[]‎</code> مصفوفة تضم النتائج.
+في حال تمرير كتلة فالقيمة المعادة للتابع <code>chdir</code> ستساوي قيمة تلك الكتلة.
 == أمثلة ==
-أمثلة عن استخدام التابع <code>Dir[]‎</code>:<syntaxhighlight lang="ruby">
+أمثلة عن استخدام التابع <code>chdir‎</code>:<syntaxhighlight lang="ruby">
-Dir["config.?"]                     #=> ["config.h"]
+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/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-5B-5D <nowiki>قسم  التابع [] في الصنف Dir في توثيق روبي الرسمي.</nowiki>]
+* [http://ruby-doc.org/core-2.5.1/Dir.html#method-c-chdir قسم  التابع chdir في الصنف Dir في توثيق روبي الرسمي.]