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