التابع IO.sysread في روبي
يقرأ التابع sysread maxlen (انظر فقرة البنية العامة) بايتًا باستخدام قراءة منخفضة المستوى (low-level read)، ثم يُعيدها كسلسلة نصية.
لا تخلط هذا التابع مع التوابع الأخرى التي تقرأ من المجرى، أو قد تحصل على نتائج غير متوقعة.
في حال إعطاء الوسيط الاختياري outbuf، فينبغي أن يشير إلى سلسلة نصية، والتي ستتلقى البيانات. لن يحتوي outbuf إلا البيانات المستلمة بعد استدعاء التابع حتى لو لم يكن فارغاً في البداية.
يُطلق الاستثناء SystemCallError عند حدوث خطأ، أو EOFError عند نهاية الملف.
البنية العامة
sysread(maxlen[, outbuf]) → string
المعاملات
maxlen
الحد الأقصى للبايتات المقروءة
outbuf
سلسلة نصية تتلقى البيانات
القيمة المُعادة
يعيد التابع sysread maxlen السلسلة النصية المقروءة.
أمثلة
مثال على استخدام التابع sysread:
f = File.new("testfile")
f.sysread(16) #=> "This is line one"
انظر أيضا
- التابع
read: يقرأ عددا من البايتات من مجرى د/خ.
- التابع
readbyte: يقرأ البايت كما يفعل التابعIO#getbyte، إلا أنه يُطلق الاستثناءEOFErrorعند نهاية الملف. - التابع
syswrite: يكتب السلسلة النصية المعطاة في مجرى د/خ الذي استُدعي معه