الفرق بين المراجعتين ل"Ruby/ARGF/readlines"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.readlines</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby AR...') |
|||
سطر 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 | ||
سطر 9: | سطر 9: | ||
readlines(sep, limit) → array | readlines(sep, limit) → array | ||
+ | </syntaxhighlight> | ||
− | الوسائط | + | == الوسائط == |
− | sep | + | |
− | المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: /$. | + | === <code>sep</code> === |
− | limit | + | المحرف المستعمل كفاصل سطري. القيمة الافتراضية هي: <code>/$</code>. |
+ | |||
+ | === <code>limit</code> === | ||
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | ||
− | + | ||
==القيم المعادة== | ==القيم المعادة== | ||
− | تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى | + | تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى <code>ARGF</code>، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. |
==أمثلة== | ==أمثلة== | ||
مثال لاستخدام التابع <code>readlines</code>: | مثال لاستخدام التابع <code>readlines</code>: | ||
سطر 24: | سطر 27: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
− | * التابع [[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/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى | + | * التابع [[Ruby/ARGF/readpartial | <code>readpartial</code>]]: يقرأ عددًا من البايتات لا يتجاوز قيمةً حديةً عليا من المجرى <code>ARGF</code>. |
− | * التابع [[Ruby/ARGF/to_a | <code>to_a</code>]]: يقرأ الملف الحالي في المجرى | + | * التابع [[Ruby/ARGF/to_a | <code>to_a</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل ثم يضع محتوياته في مصفوفة. |
==مصادر== | ==مصادر== | ||
− | * قسم التابع readlines في الصنف ARGF في توثيق روبي الرسمي. | + | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-readlines قسم التابع readlines في الصنف ARGF في توثيق روبي الرسمي.] |
مراجعة 18:16، 10 سبتمبر 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
بشكل كامل ثم يضع محتوياته في مصفوفة.