التابع IO.binread في روبي
يفتح التابع binread الملف ثم يحرِّك موضع المؤشر بمقدار محدد (في حال إعطائه) ثم يجلب جميع محتوى الملف بدءًا من موضع المؤشر وحتى نهاية الملف أو يجلب حجم محدَّد من البيانات.
يتأكد التابع binread من إغلاق الملف قبل إنهاية العملية. يفتح التابع الملف في الوضع "rb:ASCII-8BIT".
البنية العامة
binread(name, [length [, offset]] )→ string
المعاملات
name
اسم الملف المراد فتحه وجلب البيانات منه.
length
عدد صحيح يمثل عدد البايتات المراد جلبها من الملف. القيمة الافتراضية هي قراءة وجلب البيانات بدءًا من موضع الموشر الحالي (وبعد إزاحته بمقدار offset إن أعطي هذا المعامل) وحتى نهاية الملف.
offset
عدد صحيح يمثل مقدار إزاحة مؤشر المجرى في الملف الذي ستبدأ عنده عملية قراءة وجلب البيانات بدءًا من الموضع الحالي.
القيمة المعادة
تعاد سلسلة نصية تحوي البيانات التي قُرأَت من الملف ذي الاسم name والتي تمتد بدءًا من موضع الموشر الحالي (وبعد إزاحته بمقدار offset إن أعطي هذا المعامل) وحتى length بايت (إن أعطي هذا المعامل) أو حتى نهاية الملف.
أمثلة
مثال على استخدام التابع binread:
IO.binread("testfile") #=> "This is line one\nThis is line two\nThis is line three\nAnd so on...\n"
IO.binread("testfile", 20) #=> "This is line one\nThi"
IO.binread("testfile", 20, 10) #=> "ne one\nThis is line "
انظر أيضًا
- التابع
binwrite: يشبه التابعwriteباستثناء أنه يفتح الملف في الوضع الثنائي (binary mode) وبالترميز ASCII-8BIT.