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