الفرق بين المراجعتين لصفحة: «Ruby/ARGF/readpartial»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| (مراجعة متوسطة واحدة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يقرأ التابع <code>readpartial</code> عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى | يقرأ التابع <code>readpartial</code> عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى <code>ARGF</code>. | ||
سيطلق التابع <code>readpartial</code> الخطأ <code>EOFError</code> عند الوصول إلى نهاية المجرى | سيطلق التابع <code>readpartial</code> الخطأ <code>EOFError</code> عند الوصول إلى نهاية المجرى <code>ARGF</code>؛ لما كان المجرى <code>ARGF</code> يتألف من سلسلة من عدة ملفات، فسيوجد محرف نهاية الملف (EOF) في نهاية كل ملف. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> readpartial(maxlen) → string | <syntaxhighlight lang="ruby">readpartial(maxlen) → string | ||
readpartial(maxlen, outbuf) → outbuf | readpartial(maxlen, outbuf) → outbuf | ||
| سطر 18: | سطر 18: | ||
عدد البايتات الأعظمي المراد قراءته من المجرى <code>ARGF</code>. | عدد البايتات الأعظمي المراد قراءته من المجرى <code>ARGF</code>. | ||
== <code>outbuf</code> == | === <code>outbuf</code> === | ||
سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى <code>ARGF</code>. | سلسلةٌ نصيةٌ تستعمل لتخزين البيانات المقروءة من المجرى <code>ARGF</code>. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد سلسلة نصية تمثل البيانات المقروءة من المجرى | تعاد سلسلة نصية تمثل البيانات المقروءة من المجرى <code>ARGF</code>، أو يعاد الوسيط <code>outbuf</code> (إن أعطي) بعد تخزين البيانات المقروءة فيه. | ||
تعاد سلسلة نصية فارغة عند الوصول إلى نهاية الملف ( | تعاد سلسلة نصية فارغة عند الوصول إلى نهاية الملف (EOF) في كل ملف يُقرَأ منه باستثناء الملف الأخير، إذ يطلق حينئذٍ الخطأ <code>EOFError</code> عند الوصول إلى نهاية الملف الأخير. | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى | * التابع<nowiki/>[[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readbyte | <code>readbyte</code>]]: يقرأ البايت التالي من المجرى <code>ARGF</code> ثمَّ يعيده على شكل عدد صحيح (Integer). | ||
* التابع [[Ruby/ARGF/read_nonblock | <code>read_nonblock</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى | * التابع<nowiki/>[[Ruby/ARGF/read_nonblock | <code>read_nonblock</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرى <code>ARGF</code> في وضع عدم الحجز (non-blocking mode). | ||
* التابع [[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readchar | <code>readchar</code>]]: يقرأ المحرف التالي من المجرى <code>ARGF</code> ثم يعيده على شكل سلسلة نصية. | ||
* التابع [[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/readline | <code>readline</code>]]: يقرأ السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل. | ||
* التابع [[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | * التابع<nowiki/>[[Ruby/ARGF/putc | <code>putc</code>]]: يكتب محرفًا واحدًا على المجرى <code>ios</code>. | ||
* التابع [[Ruby/ARGF/getbyte | <code>getbyte</code>]]: يجلب بايتًا واحدًا (8 بتّات) من المجرى | * التابع<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 في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readpartial قسم التابع readpartial في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 13:44، 3 أكتوبر 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.