نتائج البحث

يعتبر الصنف SystemCallError الصنف الأب لكل أصناف الأخطاء منخفضة المستوى المرتبطة بنظام التشغيل. الأخطاء المتوفرة على نظام التشغيل الحالي هي أصناف فرعية من الصنف SystemCallErrorـ وهي مُعرّفة في الوحدة Errno. File.open("does/not/exist")‎ عند تنفيذ هذا السطر البرمجي، سيطلق استثناء بالشكل التالي: Errno::ENOENT: No such file or directory - does/not/exist‎ توابع الصنف العامة (Public Class Methods) === يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى متساويين. new ...

يتحقق المعامل === إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء الآخر المعطى (انظر فقرة البنية العامة) متساويين. البنية العامة system_call_error === other → true or false‎ القيمة المعادة تعاد القيمة true إن كان الاستثناء system_call_error كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ الخاصين بهذا الاستثناء والاستثناء other متساويين. خلا ذلك، تعاد القيمة false. انظر أيضًا التابع new: ينشئ الصنف Errno المناسب لرمز خطإٍ نظامي معروف ...

ينشئ التابع new الصنف Errno المناسب لرمز خطإٍ نظامي معروف إن كان رقم الخطأ المُمرَّر إليه يطابق رمز هذا خطأ، وإلا فسينشئ كائنًا عامًا من النوع SystemCallError. رقم الخطأ سيكون متاح لاحقًا عبر التابع errno. البنية العامة new(msg, errno) → system_call_error_subclass‎ المعاملات msg‎ رسالة الخطأ. errno‎ رقم الخطأ. القيمة المعادة يعاد كائنٌ جديد من النوع SystemCallError أو صنف متفرع منه. انظر أيضا التابع ===: يتحقق إن كان الاستثناء الذي استُدعي معه كائنًا عامًا من الصنف SystemCallError، أو إن كان رقما الخطأ ...

يعيد التابع errno رقم الخطأ الخاص بالكائن SystemCallError الذي استُدعي معه. البنية العامة errno→ integer‎ القيمة المعادة يعاد رقم الخطأ الخاص بالكائن SystemCallError المعطى. انظر أيضًا التابع new: ينشئ كائنًا جديدًا من النوع SystemCallError. مصادر قسم التابع errno‎ في الصنف SystemCallError‎ في توثيق روبي الرسمي.

ينشئ التابع link اسمًا جديدًا لملف موجود باستعمال وصلة صلبة (hard link). لن يُستبدَل الاسم الجديد إن كان موجودًا مسبقًا بل يرمي صنفًا فرعيًّا من الخطأ SystemCallError. هذا التابع غير متاح على جميع المنصات. البنية العامة link(old_name, new_name) → 0 المعاملات old_name اسم الملف القديم المراد إنشاء وصلة صلبة باسم جديد له. new_name الاسم الجديد للملف ذي الاسم old_name. القيمة المعادة تعاد القيمة 0 عند نجاح العملية، أو يرمى الخطأ SystemCallError إن كان الاسم الجديد المراد إنشاؤه للملف old_name موجودًا من ...

يعيد التابع children‎ مصفوفة تحوي جميع أسماء الملفات في المجلد المحدد باستثناء "." و "..". في حالة عدم وجود المجلد المحدد، فسيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط الاختياري encoding الذي يحدِّد ترميز المجلد. أمَّا إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات نفسه. البنية العامة children( dirname ) → array children( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المُحدد المراد معرفة محتواه. encoding ترميز المجلد. إن لم يُحدّد، فسيٌستخدم ترميز نظام الملفات. القيمة المعادة تُعاد مصفوفة تحوي جميع ...

يحذف التابع unlink‎ مجلدًا محدَّدًا. سيُطلق خطأٌ من صنف فرعي من SystemCallError في حال لم يكن المجلد فارغًا. البنية العامة unlink( string ) → 0 المعاملات string اسم المجلد المُراد حذفه. انظر أيضًا التابع delete‎: يحذف مجلدًا محدَّدًا.  التابع rmdir‎: مجلدًا محدَّدًا.  مصادر قسم التابع unlink في الصنف Dir في توثيق روبي الرسمي.

يحذف التابع rmdir‎ مجلدًا محدَّدًا. سيُطلق خطأٌ من صنف فرعي من SystemCallError  في حال لم يكن المجلد فارغًا. البنية العامة rmdir( string ) → 0 المعاملات string اسم المجلد المُراد حذفه. انظر أيضًا التابع delete‎: يحذف مجلدًا محدَّدًا.  التابع unlink‎: يحذف مجلدًا محدَّدًا.   مصادر قسم التابع rmdir في الصنف Dir في توثيق روبي الرسمي.

يحذف التابع delete‎ مجلدًا محدَّدًا. سيُطلق خطأ من صنف فرعي من SystemCallError في حال لم يكن المجلد المراد حذفه موجودًا. البنية العامة delete( string ) → 0 المعاملات string اسم المجلد المُراد حذفه. انظر أيضًا التابع chdir‎ : يغيِّر مجلد العمل (working directory) الحالي للعملية إلى مجلد محدَّد. التابع rmdir‎ :يحذف مجلدًا محدَّدًا.  مصادر قسم التابع delete في الصنف Dir في توثيق روبي الرسمي.

يُطلق الاستثناء IOError عند فشل عملية إدخال/إخراج (IO operation) في روبي. File.open("/etc/hosts") {|f| f << "example"} #=> IOError: not opened for writing File.open("/etc/hosts") {|f| f.close; f.read } #=> IOError: closed stream تذكر أنَّ فشل بعض عمليات الإدخال/الإخراج قد يؤدي إلى إطلاق الاستثناء SystemCallError، وهذا الاستثناء ليس متفرع من الصنف IOError. File.open("does/not/exist") #=> Errno::ENOENT: No such file or directory - does/not/exist مصادر صفحة الصنف IOError في توثيق روبي الرسمي.

ينشئ التابع mkdir مجلدًا جديدًا باسم محدَّد، مع تحديد أذوناته أيضًا. يمكن تعديل الأذونات بواسطة File::umask، ويتم تجاهلها في NT. إن لم يكن بالإمكان إنشاء المجلد، فسيُطلق الخطأ SystemCallError. راجع أيضًا مناقشة الأذونات في توثيق الصنف File. البنية العامة mkdir( string [, integer] ) → 0 المعاملات string  اسم المجلد الجديد المراد إنشاؤه. integer أذونات المجلد الجديد المراد إنشاؤه. أمثلة مثال عن استخدام التابع mkdir: Dir.mkdir(File.join(Dir.home, ".foo"), 0700) #=> 0 انظر أيضًا التابع chdir: يغيِّر مجلد العمل (working directory) الحالي ...

يعيد التابع entries‎ مصفوفةً تحتوي جميع أسماء الملفات الموجودة في المجلد المحدد. في حال عدم وجود هذا المجلد، سيُطلق الخطأ SystemCallError. يمكن تمرير الوسيط encoding الاختياري إلى التابع الذي يحدد ترميز المجلد. أمَّا إن لم يعطَ، فسيٌستخدم ترميز نظام الملفات. البنية العامة entries( dirname ) → array entries( dirname, encoding: enc ) → array المعاملات dirname اسم المجلد المراد معرفة محتوياته. encoding ترميز المجلد. القيمة المعادة تُعاد مصفوفةٌ تحوي جميع أسماء الملفات في المجلد المحدد. أمثلة مثال عن استخدام التابع entries ...

يعيد التابع rename تسمية ملف محدَّد إلى اسم جديد. البنية العامة rename(old_name, new_name) → 0 المعاملات old_name اسم الملف القديم المراد تغييره. new_name الاسم الجديد المراد تغيير اسم الملف old_name إليه. القيمة المعادة تعاد القيمة 0 بعد تسمية الملف old_name إلى الاسم new_name الجديد، أو يرمى الخطأ SystemCallError إن لم يكن الإمكان إعادة تسمية الملف old_name لأي سبب كان. أمثلة مثال على استعمال التابع : File.rename("afile", "afile.bak") #=> 0 انظر أيضا التابع absolute_path: يحول اسم مسار محدَّد إلى مسار مطلق. ...

يكتب التابع syswrite السلسلة النصية المُمرَّرة إليه في المجرى الذي استُدعي معه باستخدام كتابة منخفض المستوى (low-level write).  لا تخلط هذا التابع مع التوابع الأخرى التي تكتب في المجرى، وإلا ستحصل على نتائج غير متوقعة. يُطلق الاستثناء SystemCallError عند حدوث خطأ. البنية العامة syswrite(string)→ integer‎ المعاملات string‎ سلسلة نصية يراد كتابتها على المجرى. القيمة المعادة يعاد عدد صحيح يمثِّل عدد البايتات المكتوبة في المجرى. أمثلة مثال على استخدام التابع syswrite‎: f = File.new("out", "w") f.syswrite("ABCDEF") #=> 6‎ انظر أيضًا التابع sysread: ...

تعدُّ كائنات الاستثناءات في روبي أصنافًا فرعيةً (subclasses) من الصنف Exception. على أي حال، تُبلِّغ أنظمة التشغيل عادةً عن الأخطاء باستخدام أعدادٍ صحيحةٍ مبسّطةٍ (plain integers). تُنشَأ الوحدة Errno ديناميكيًّا لتنظيم تفاصيل هذه الأخطاء الناتجة عن أنظمة التّشغيل وإرسالها إلى أصناف روبي، مع توليد صنف فرعي من الصنف SystemCallError خاص بكل رقم خطأٍ. عند إنشاء الصّنف الفرعي في الوحدة Errno، ستبدأ تسميته بالاسم ::Errno. تعتمد أسماء الأصناف ::Errno تعتمد على البيئة التي تعمل فيها روبي. ففي منصة يونكس أو ويندوز ...

ينتظر التابع wait2 خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) تلك العملية. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. البنية العامة wait2(pid=-1, flags=0) → [pid, status] المعاملات pid مُعرِّف العملية المراد انتظارها. اطلع على صفحة التابع wait لمزيد من التفاصيل حول هذا المعامل. flags اطلع على صفحة التابع wait لمزيد من التفاصيل حول هذا المعامل. القيم المعادة تعاد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) العملية ...

يقرأ التابع sysread عددًا محدَّدًا من البايتات من المجرى الذي استدعي معه باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية. لا تخلط هذا التابع مع التوابع الأخرى التي تقرأ من المجرى، وإلا ستحصل على نتائج غير متوقعة. يُطلَق الاستثناء SystemCallError عند حدوث خطأ، أو EOFError عند نهاية الملف. البنية العامة sysread(maxlen[, outbuf]) → string‎ المعاملات maxlen‎ عدد صحيح يمثِّل الحد الأقصى للبايتات المراد قراءتها. outbuf‎ في حال إعطاء هذا المعامل الاختياري، فينبغي أن يشير إلى السلسلة النصية التي ستتلقى البيانات المقروءة ...

ينتظر التابع waitpid2 خروج العملية الابن ثم يعيد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) تلك العملية. يطلق استدعاء هذا التابع الاستثناء SystemCallError إن لم يكن هنالك أية عمليات أبناء. البنية العامة waitpid2(pid=-1, flags=0) → [pid, status] المعاملات pid مُعرِّف العملية المراد انتظارها. اطلع على صفحة التابع wait2 لمزيد من التفاصيل حول هذا المعامل. flags اطلع على صفحة التابع wait2 لمزيد من التفاصيل حول هذا المعامل. القيم المعادة تعاد مصفوفة تحوي مُعرِّف وحالة الخروج (كائنًا من النوع Process::Status) العملية ...

يقرأ التابع pread من المجرى الذي استدعي معه عددًا محدَّدًا من البايتات باستخدام استدعاء النظام pread، ثم يُعيدها كسلسلة نصية من غير تعديل إزاحة (offset) الواصف الأساسي. هذا التابع مفيد مقارنة بالجمع بين التابعين seek و read معًا في كونه ذريًا (atomic)، مما يسمح لعدة مهام فرعية/عمليات بتشارك نفس المجرى لقراءة الملف من مواضع مختلفة. هذا سيتجاوز أي مساحة تخزين مؤقت للمستخدمين في المجرى. سيُطلق الاستثناء SystemCallError عند حصول خطأ، أو الاستثناء EOFError عند الوصول إلى نهاية الملف، أو الاستثناء NotImplementedError ...

يكتب التابع pwrite السلسلة النصية المُمرَّرة إليه في موضع محدَّد من المجرى الذي استُدعي معه باستخدام استدعاء دالة النظام pwrite()‎. هذا مفيد مقارنة بالجمع بين التابعين seek و write معا في كونه ذريًا (atomic)، مما يسمح لعدة مهام فرعية/عمليات بالتشارك في نفس المجرى لقراءة الملف من مواضع مختلفة. هذا سيتجاوز أي مساحة تخزين مؤقت للمستخدمين من المجرى. سيعيد التابع pwrite عدد البايتات المكتوبة، أو سيُطلق الاستثناء SystemCallError في حال حدوث خطأ، أو NotImplementedError إذا لم يكن نظام الشغيل يدعم استدعاء النظام. البنية ...