الفرق بين المراجعتين لصفحة: «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
بشكل كامل ثم يضع محتوياته في مصفوفة.