الفرق بين المراجعتين لصفحة: «Ruby/ARGF/to a»

من موسوعة حسوب
< Ruby‏ | ARGF
لا ملخص تعديل
ط مراجعة وتدقيق.
 
سطر 3: سطر 3:
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby ARGF]]
[[تصنيف: Ruby ARGF]]
يقرأ التابع <code>to_a</code> الملف الحالي في المجرى <code>ARGF</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>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>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>.
* التابع<nowiki/>[[Ruby/ARGF/read | <code>read</code>]]: يقرأ عددًا محددًا من البايتات من المجرى <code>ARGF</code>.
* التابع [[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل.
* التابع<nowiki/>[[Ruby/ARGF/readlines | <code>readlines</code>]]: يقرأ الملف الحالي في المجرى <code>ARGF</code> بشكل كامل.
* التابع [[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>.
* التابع<nowiki/>[[Ruby/ARGF/gets | <code>gets</code>]]: يجلب السطر التالي من الملف الحالي في المجرى <code>ARGF</code>.
* التابع [[Ruby/ARGF/write | <code>write</code>]]: يكتب السلسلة النصية الممرَّرة إليها على المجرى <code>ARGF</code> في حال كان الوضع <code>inplace</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 مفعَّلًا.

مصادر