نتائج البحث

(PHP 4, PHP 5, PHP 7) تعيد الدالة fstat()‎ معلومات عن ملف باستعمال مؤشِّر ملف مفتوح يشير إليه. الوصف array fstat ( resource $handle ) تجمع هذه الدالة بعض المعلومات الإحصائيَّة عن الملف المفتوح الذي يشير إليه المورد handle. تشبه هذه الدالة إلى حدٍّ كبير الدالة stat()‎ باستثناء أنَّها تتعامل مع مؤشِّر ملف مفتوح عوضًا عن مسار الملف. المعاملات handle مؤشِّر (pointer) يشير إلى ملف. يجب أن يكون سليمًا، ويشير إلى ملف فُتح بطريقة صحيحة باستعمال الدالة fopen()‎. القيم المعادة تُعاد ...

يُسلسل (Serializes) التابع dump الكائن المعطى وجميع الكائنات المنحدرة منه (descendant objects). في حال تمرير كائن من النوع IO، فستُكتب البيانات المُسَلسلة فيه، وإلا فستُعاد البيانات كسلسلة نصية. البنية العامة dump( obj [, anIO] , limit=-1 ) → anIO‎ في حال تمرير المعامل limit، فسيقتصر التابع dump على سَلسَلة الكائنات الفرعية حتى العمق المحدد. إذا كان limit سالبًا، لن يكون هناك أي تحقق من للعمق. لا يمكن للتابع Marshal تفريغ (dump) الكائنات التالية: الوحدات أو الأصناف المجهولة (anonymous Class/Module). الكائنات المرتبطة بالنظام (مثل ...

يرتِّب التابع sort_by عناصر الكائن القابل للتعداد الذي استدعي معه باستعمال مجموعة من المفاتيح المولدة عبر تمرير قيم العناصر إلى الكتلة المعطاة. لا يُضمَن بأن تكون النتيجة مستقرة. عندما تعيد عملية الموازنة بين مفتاحين القيمة 0، إذ لن يُتوقَع كيفية ترتيب هذين العنصرين ومن منهما سيسبق الآخر. إن لم تُعطَ أية كتلة، فسيعيد التابع كائنًا جديدًا من النوع Enumerator. البنية العامة sort_by { |obj| block } → array sort_by → an_enumerator التنفيذ الحالي للتابع sort_by يولد مصفوفةً من الصفوف (tuples) تحوي مجموعة العناصر الأصلية ...

يعيد التابع size حجم الملف المحدَّد. البنية العامة size(file_name) → integer المعاملات file_name اسم الملف المراد معرفة حجمه. القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف file_name. انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

يُعيد التابع default_external:: قيمة الترميز الخارجي الافتراضية. يُستخدَم التّرميز الخارجي الافتراضي دومًا مع السّلاسل النصّية التي أُنشئت في الأماكن التّالية: الملفات ذات الصيغة CSV. بيانات الصنف File المقروءة من القرص. الصنف SDBM. الصنف StringIO. الصنف Zlib::GzipReader. الصنف Zlib::GzipWriter. التابع String.inspect. التابع Regexp.inspect. إن السلسلة النصية المنشأة من هذه الأماكن ستكون مرمَّزةً بهذا الترميز، ولكن قد يكون هذا الترميز غير صالح لها. حاول دومًا أن تتحقّق من ذلك من خلال التابع ?String.valid_encoding. يُغيَّر ترميز بيانات الصنف File عند كتابتها إلى القرص ...

يضبط التابع inplace_mode عند استدعائه بالشكل inplace_mode = ext امتداد اسم الملف بوضعية التعديل الموضعي (in-place editing mode) إلى السلسلة النصية ext المعطاة. تضاف هذه القيمة المعطاة إلى أسماء كل الملفات التي يتم تعديلها، ويُحفَظ الملف المُعدَّل تحت هذا الاسم الجديد. البنية العامة inplace_mode = ext → ARGF القيمة المعادة يعاد المجرى ARGF. أمثلة ستُبدِّل الشيفرة التالية العبارة "bar" مكان أول ظهور للعبارة "foo" في كل سطر من أسطر الملف file.txt ثمَّ سيُكتب السطر الجديد في الملف file.txt.bak: $ ruby ...

يعيد التابع size حجم الملف الذي استدعي معه. البنية العامة size → integer القيمة المعادة يعاد عدد صحيح يمثِّل حجم الملف المعطى. أمثلة مثال على استعمال التابع size: File.new("testfile").size #=> 66 انظر أيضا التابع size?‎: يتحقق إن كان ملفٌ ما غير موجود أو معدوم الحجم. مصادر قسم التابع size في الصنف File في توثيق روبي الرسمي.

الصنف ARGF هو مجرى (stream) صُمِّم ليُستخدَم في الملفات البرمجية (scritps) التي تُعالج الملفات المُمرَّرة إليها على شكل وسائط في سطر الأوامر (command-line arguments)، أو المُمرَّرة عبر مجرى الدخل القياسي (STDIN). تُخزَّن الوسائط المُمرَّرة للملف البرمجي في المصفوفة ARGV، إذ يخزَّن وسيط واحد في كل عنصر. تفترض ARGF أنّ الوسائط التي ليست أسماء ملفات (filenames) قد أزيلت من ARGV. انظر الشيفرة التالية مثلًا: $ ruby argf.rb --verbose file1 file2 ARGV #=> ["--verbose", "file1", "file2"] option = ARGV.shift #=> "--verbose" ARGV #=> ...

معظم أخطاء الأنواع تنحدر من الصنف StandardError؛ ستُعالج الكتلة rescue التي لا تحدد الصنف Exception بشكل صريح كل الأخطاء StandardError (دون غيرها). def foo raise "Oups" end foo rescue "Hello" #=> "Hello" الشيفرة التالية: require 'does/not/exist' rescue "Hi" ستطلق استثناء بالشكل التالي: LoadError: no such file to load -- does/not/exist مصادر صفحة الصنف StandardError في توثيق روبي الرسمي.

يوسّع التابع glob الوسيطَ pattern الممرّر (انظر فقرة البنية العامة)، الذي هو سلسلة نصية نمطية (pattern string) أو مصفوفة من السلاسل النصية النمطية، ويعيد مصفوفة تحتوي أسماء الملفات المُطابقة لذلك النمط. في حال تم إعطاء كتلة (block)، فسيستدعي التابع glob الكتلة مرة واحدة على كل اسم ملف مطابق، إذ سيمرّر اسم الملف كوسيط إلى الكتلة. يحدِّد الوسيط base الاختياري المجلد الأساسي (base directory) لتفسير أسماء المسارات النسبية بدلاً من مجلد العمل الحالي. وبما أنّ النتائج لا تكون مسبوقة باسم المجلد ...