الفرق بين المراجعتين لصفحة: «Ruby/ARGF/to a»
أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>ARGF.to_a</code> في روبي}}</noinclude> تصنيف: Ruby تصنيف: Ruby Method تصنيف: Ruby ARGF...' |
لا ملخص تعديل |
||
| سطر 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 | ||
| سطر 12: | سطر 12: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==المعاملات== | ==المعاملات== | ||
<code>sep</code> | |||
المحرف المستعمل كفاصل سطري في الملف المراد القراءة منه. القيمة الافتراضية هي: /$. | === <code>sep</code> === | ||
<code>limit</code> | المحرف المستعمل كفاصل سطري في الملف المراد القراءة منه. القيمة الافتراضية هي: <code>/$</code>. | ||
=== <code>limit</code> === | |||
عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | عددٌ يحدد الأحرف المراد قراءتها من كل سطر. افتراضيًا، ستُقرَأ كل المحارف الموجودة في السطر. | ||
==القيم المعادة== | ==القيم المعادة== | ||
تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى | تعاد مصفوفة تحوي جميع محتويات الملف الحالي المقروء من المجرى <code>ARGF</code>، إذ يُخزَّن كل سطر في عنصر واحد من عناصرها. | ||
==أمثلة== | ==أمثلة== | ||
مثال لاستخدام التابع <code>to_a</code>: | مثال لاستخدام التابع <code>to_a</code>: | ||
| سطر 25: | سطر 27: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==انظر أيضًا== | ==انظر أيضًا== | ||
* التابع [[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى | * التابع [[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى | * التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل. | ||
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى | * التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>. | ||
* التابع [[Ruby/ARGF/write | <code>write</code>]]: يكتب السلسلة النصية الممرَّرة إليها على المجرى | * التابع [[Ruby/ARGF/write | <code>write</code>]]: يكتب السلسلة النصية الممرَّرة إليها على المجرى <code>ARGF</code> في حال كان الوضع <code>inplace</code> مفعَّلًا. | ||
==مصادر== | ==مصادر== | ||
* قسم التابع to_a في الصنف ARGF في توثيق روبي الرسمي. | * [http://ruby-doc.org/core-2.5.1/ARGF.html#method-i-to_a قسم التابع to_a في الصنف ARGF في توثيق روبي الرسمي.] | ||
مراجعة 11:14، 11 سبتمبر 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مفعَّلًا.