عرض مصدر Ruby/ARGF/readpartial

<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.readpartial</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby ARGF]]
يقرأ التابع <code>readpartial</code> عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى <code>ARGF</code>.

سيطلق التابع <code>readpartial</code> الخطأ <code>EOFError</code> عند الوصول إلى نهاية المجرى <code>ARGF</code>؛ لما كان المجرى <code>ARGF</code> يتألف من سلسلة من عدة ملفات، فسيوجد محرف نهاية الملف (EOF) في نهاية كل ملف.
==البنية العامة==
<syntaxhighlight lang="ruby">readpartial(maxlen) → string
readpartial(maxlen, outbuf) → outbuf


 </syntaxhighlight>

== الوسائط ==

=== <code>maxlen</code> ===
عدد البايتات الأعظمي المراد قراءته من المجرى <code>ARGF</code>.

=== <code>outbuf</code> ===
سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى <code>ARGF</code>.

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

تعاد سلسلة نصية فارغة عند الوصول إلى نهاية الملف (EOF) في كل ملف يُقرَأ منه باستثناء الملف الأخير، إذ يطلق حينئذٍ الخطأ <code>EOFError</code> عند الوصول إلى نهاية الملف الأخير.
==انظر أيضًا==
* التابع<nowiki/>[[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>.
* التابع<nowiki/>[[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى <code>ARGF</code> ثمَّ يعيده على شكل عدد صحيح (Integer).
* التابع<nowiki/>[[Ruby/ARGF/read_nonblock | <code>read_nonblock</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى <code>ARGF</code> في وضع عدم الحجز (non-blocking mode).
* التابع<nowiki/>[[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية.
* التابع<nowiki/>[[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى <code>ARGF</code>.
* التابع<nowiki/>[[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل.
* التابع<nowiki/>[[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>.
* التابع<nowiki/>[[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى <code>ARGF</code>.
==مصادر==
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readpartial قسم التابع readpartial في الصنف ARGF في توثيق روبي الرسمي.]