الفرق بين المراجعتين لصفحة: «Ruby/ARGF/readpartial»

مراجعة 18:19، 10 سبتمبر 2018

يقرأ التابع readpartial عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى ARGF.

سيطلق التابع readpartial الخطأ EOFError عند الوصول إلى نهاية المجرى ARGF؛ لما كان المجرى ARGF يتألف من سلسلة من عدة ملفات، فسيوجد محرف نهاية الملف (EOF) في نهاية كل ملف.

البنية العامة

 readpartial(maxlen) → string
readpartial(maxlen, outbuf) → outbuf

الوسائط

`maxlen`

عدد البايتات الأعظمي المراد قراءته من المجرى ARGF.

`outbuf`

سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى ARGF.

القيم المعادة

تعاد سلسلة نصية تمثل البيانات المقروءة من المجرى ARGF، أو يعاد الوسيط outbuf (إن أعطي) بعد تخزين البيانات المقروءة فيه.

تعاد سلسلة نصية فارغة عند الوصول إلى نهاية الملف (EOF) في كل ملف يُقرَأ منه باستثناء الملف الأخير، إذ يطلق حينئذٍ الخطأ EOFError عند الوصول إلى نهاية الملف الأخير.

انظر أيضًا

التابع read: يقرأ عددًا محددًا من البايتات من المجرى ARGF.
التابع readbyte: يقرأ البايت التالي من المجرى ARGF ثمَّ يعيده على شكل عدد صحيح (Integer).
التابع read_nonblock: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى ARGF في وضع عدم الحجز (non-blocking mode).
التابع readchar: يقرأ المحرف التالي من المجرى ARGF ثم يعيده على شكل سلسلة نصية.
التابع readline: يقرأ السطر التالي من الملف الحالي في المجرى ARGF.
التابع readlines: يقرأ الملف الحالي في المجرى ARGF بشكل كامل.
التابع putc: يكتب محرفًا واحدًا على المجرى ios.
التابع getbyte: يجلب بايتًا واحدًا (8 بتّات) من المجرى ARGF.

مصادر

قسم التابع readpartial في الصنف ARGF في توثيق روبي الرسمي.

@@ سطر 18: / سطر 18: @@
 عدد البايتات الأعظمي المراد قراءته من المجرى <code>ARGF</code>.
-== <code>outbuf</code> ==
+=== <code>outbuf</code> ===
 سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى <code>ARGF</code>.