الفرق بين المراجعتين لصفحة: «Ruby/ARGF/readlines»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby ARGF]] | [[تصنيف: Ruby ARGF]] | ||
يقرأ التابع <code>readlines</code> الملف الحالي في المجرى | يقرأ التابع <code>readlines</code> الملف الحالي في المجرى <code>ARGF</code> بشكل كامل. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby"> readlines(sep=$/) → array | <syntaxhighlight lang="ruby">readlines(sep=$/) → array | ||
readlines(limit) → array | readlines(limit) → array | ||
readlines(sep, limit) → array | readlines(sep, limit) → array | ||
| سطر 20: | سطر 20: | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى | تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى <code>ARGF</code>، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. | ||
==أمثلة== | ==أمثلة== | ||
مثال لاستخدام التابع <code>readlines</code>: | مثال لاستخدام التابع <code>readlines</code>: | ||
<syntaxhighlight lang="ruby"> lines = ARGF.readlines | <syntaxhighlight lang="ruby">lines = ARGF.readlines | ||
lines[0] #=> "This is line one\n" | lines[0] #=> "This is line one\n" | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[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/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى | * التابع<nowiki/>[[Ruby/ARGF/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/to_a | <code>to_a</code>]]: يقرأ الملف الحالي في المجرى | * التابع<nowiki/>[[Ruby/ARGF/to_a | <code>to_a</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل ثم يضع محتوياته في مصفوفة. | ||
==مصادر== | ==مصادر== | ||
* [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readlines قسم التابع readlines في الصنف ARGF في توثيق روبي الرسمي.] | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readlines قسم التابع readlines في الصنف ARGF في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 13:44، 3 أكتوبر 2018
يقرأ التابع readlines الملف الحالي في المجرى ARGF بشكل كامل.
البنية العامة
readlines(sep=$/) → array
readlines(limit) → array
readlines(sep, limit) → array
الوسائط
sep
المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$.
limit
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر.
القيم المعادة
تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى ARGF، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها.
أمثلة
مثال لاستخدام التابع readlines:
lines = ARGF.readlines
lines[0] #=> "This is line one\n"
انظر أيضًا
- التابع
read: يقرأ عددًا محددًا من البايتات من المجرىARGF. - التابع
readbyte: يقرأ البايت التالي من المجرىARGFثمَّ يعيده على شكل عدد صحيح (Integer). - التابع
read_nonblock: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديَّةً عليا من المجرىARGFفي وضع عدم الحجز (non-blocking mode). - التابع
readchar: يقرأ المحرف التالي من المجرىARGFثم يعيده على شكل سلسلة نصية. - التابع
readline: يقرأ السطر التالي من الملف الحالي في المجرىARGF. - التابع
readpartial: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرىARGF. - التابع
to_a: يقرأ الملف الحالي في المجرىARGFبشكل كامل ثم يضع محتوياته في مصفوفة.