التابع IO.sysread في روبي
يقرأ التابع sysread maxlen (انظر فقرة البنية العامة) بايتًا من مجرى د/خ الذي استُدعي معه ios باستخدام قراءة منخفضة المستوى (low-level read) ويُعيدها كسلسلة نصية. لا تخلط هذا التابع مع التوابع الأخرى التي تقرأ من مجرى د/خ ios، أو قد تحصل على نتائج غير متوقعة.
في حال إعطاء الوسيط الاختياري outbuf، فينبغي أن يشير إلى سلسلة نصية String، والتي ستتلقى البيانات. لن يحتوي outbuf إلا البيانات المستلمة بعد استدعاء التابع حتى إذا لم يكن فارغاً في البداية.
يُطلق الاستثناء SystemCallError عند حدوث خطأ، و EOFError عند نهاية الملف.
البنية العامة
sysread(maxlen[, outbuf]) → string
المعاملات
maxlen
الحد الأقصى
outbuf
سلسلة نصية تتلقى البيانات
القيمة المُعادة
أمثلة
مثال على استخدام التابع sysread:
f = File.new("testfile")
f.sysread(16) #=> "This is line one"
انظر أيضا
- التابع
sync=: يضبط قيمة راية وضع المزامنة “sync mode' عند إحدى القيمتينtrueأوfalse. عندما تكون قيمة وضع المزامنة true، فسيتم إرسال كل المخرجات فورًا إلى نظام التشغيل، ولن تُخزن (buffered) داخليًا. يُعيد الحالة الجديدة. انظر أيضا صفحةIO#fsync. - التابع
sysseek: يسعى إلى التموضع عند الإزاحة المعطاةoffset(انظر فقرة البنية العامة) وفقا لقيمةwhence(انظرIO#seekللتعرف على القيم الممكنة للوسيطwhence). يُعيد الإزاحة الجديدة للملف.