Ruby/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). يُعيد الإزاحة الجديدة للملف.

مصادر

• قسم التابع sysread‎ في الصنف IO‎ في توثيق روبي الرسمي.