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

المراجعة الحالية بتاريخ 07:08، 22 ديسمبر 2018

يقرأ التابع readlines ملفًا بأكمله سطرًا سطرًا ثم يعيد تلك الأسطر في مصفوفة.

إن كان الوسيط الأخير عبارة عن جدول Hash، فسيمثِّل الوسيط المسمى (keyword argument) المراد فتحه.

البنية العامة

readlines(name, sep=$/ [, getline_args, open_args])  → array
readlines(name, limit [, getline_args, open_args])→ array
readlines(name, sep, limit [, getline_args, open_args]) → array‎

المعاملات

`name‎`

اسم الملف المراد قراءة أسطره ووضعها في مصفوفة.

`sep‎`

الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: /$.

`getline_args‎`

كائن من النوع Hash يقبل المفتاح الوحيد التالي:

‎:chomp - عندما يُعطى للوسيط المسمى الاختياري chomp قيمة صحيحة (true value)، فستتم إزالة المحارف ‎\n و ‎\r و ‎\r\n من نهاية كل سطر.

`open_args‎`

مصفوفة أو جدول Hash يوفر خيارات الفتح. اطلع على صفحة التابع read لمزيد من التفاصيل حول المعامل open_args.

`limit‎`

الحد الأقصى للأسطر المقروءة.

القيمة المعادة

تعاد مصفوفة يحوي كل عنصر من عناصرها سطرًا من أسطر الملف ذي الاسم name.

أمثلة

مثال على استخدام التابع readlines‎:

a = IO.readlines("testfile")
a[0]   #=> "This is line one\n"
b = IO.readlines("testfile", chomp: true)
b[0]   #=> "This is line one"‎

انظر أيضًا

التابع foreach: ينفذ الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى.

التابع read: يقرأ ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج.

مصادر

قسم التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE: التابع <code>readlines‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude>
+<noinclude>{{DISPLAYTITLE: التابع <code>IO.readlines‎</code> في روبي}}</noinclude>
 [[تصنيف: Ruby]]
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يقرأ التابع <code>readlines</code> كامل الملف المحدد بواسطة <code>name</code> (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في [[Ruby/Array|مصفوفة]]. تُفصل السطو بواسطة <code>sep</code>.
+يقرأ التابع <code>readlines</code> ملفًا بأكمله سطرًا سطرًا ثم يعيد تلك الأسطر في [[Ruby/Array|مصفوفة]].
+إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|جدول Hash]]، فسيمثِّل الوسيط المسمى (keyword argument) المراد فتحه.
-إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|قاموس]]، فسيتم فتح الوسيط المسمى (keyword argument).
-خيارات getline
-<code>[[Ruby//readlines-label-Options+for+getline|¶]]</code> <code>[[Ruby//top|↑]]</code>
-يقبل [[Ruby/Hash|قاموس]] الخيارات المفاتيح التالية:
-‎:chomp
-عندما يُعطى للوسيط المسمى الاختياري <code>chomp</code> قيمة صحيحة، ستتم إزالة <code>\n</code> و <code>\r</code> و <code>\r\n</code> من نهاية كل سطر.
-وانظر أيضا صفحة <code>[[Ruby/IO/read|::read]]</code> لمزيد من التفاصيل حول open_args.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args])  → array
@@ سطر 25: / سطر 12: @@
 ==المعاملات==
 ===<code>name‎</code>===
-اسم الملف
+اسم الملف المراد قراءة أسطره ووضعها في مصفوفة.
 ===<code>sep‎</code>===
-فاصل
+الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: <code>/$</code>.
-===<code>getline_args‎</code>===
+=== <code>getline_args‎</code> ===
+كائن من النوع <code>Hash</code> يقبل المفتاح الوحيد التالي:
+* <code>‎:chomp</code> - عندما يُعطى للوسيط المسمى الاختياري <code>chomp</code> قيمة صحيحة (true value)، فستتم إزالة المحارف ‎<code>\n</code> و ‎<code>\r</code> و ‎<code>\r\n</code> من نهاية كل سطر.
 ===<code>open_args‎</code>===
-مصفوفة توفر خيارات الفتح
+[[Ruby/Array|مصفوفة]] أو <nowiki/>[[Ruby/Hash|جدول Hash]] يوفر خيارات الفتح. اطلع على صفحة التابع <code>[[Ruby/IO/read|read]]</code> لمزيد من التفاصيل حول المعامل <code>open_args</code>.
 ===<code>limit‎</code>===
-==القيمة المُعادة==
+الحد الأقصى للأسطر المقروءة.
+==القيمة المعادة==
+تعاد [[Ruby/Array|مصفوفة]] يحوي كل عنصر من عناصرها سطرًا من أسطر الملف ذي الاسم <code>name</code>.
 ==أمثلة==
-مثال على استخدام التابع <code>readlines‎</code>:
+مثال على استخدام التابع <code>readlines‎</code>:<syntaxhighlight lang="ruby">a = IO.readlines("testfile")
-<syntaxhighlight lang="ruby">a = IO.readlines("testfile")
 a[0]   #=> "This is line one\n"
 b = IO.readlines("testfile", chomp: true)
 b[0]   #=> "This is line one"‎</syntaxhighlight>
-==انظر أيضا==
+==انظر أيضًا==
-* التابع <code>[[Ruby/IO/read|read]]</code>: يفتح التابع <code>read</code> الملف، ثم يتموضع اختياريا في الموضع المعطى <code>offset</code> (انظر فقرة البنية العامة)، ثم يُعيد <code>length</code> بايت (تساوي قيمته الافتراضية طول بقية الملف).  يضمن التابع <code>read</code> أن يُغلق الملف قبل العودة.
+*التابع [[Ruby/IO/foreach|<code>foreach</code>]]: ينفذ الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى.
-* التابع <code>[[Ruby/IO/select|select]]</code>: يستدعي التابع <code>select</code> select(2)‎. ويقوم بمراقبة [[Ruby/Array|المصفوفة]] المعطاة المكونة من [[Ruby/IO|مجرى د/خ]] (كائنات <code>IO</code>)، وينتظر حتى يكون أحد كائنات <code>IO</code> جاهزًا للقراءة، وجاهزا للكتابة، ويكون لها استثناءات معلقة (pending exceptions) على التوالي، ثم يعيد [[Ruby/Array|مصفوفة]] تحتوي على [[Ruby/Array|مصفوفات]] مكونة من [[Ruby/IO|مجرى د/خ]] تلك كائنات <code>[[Ruby/IO|IO]]</code> السابقة.  ستعاد القيمة <code>nil</code> إذا تم إعطاء قيمة للوسيط الاختياري <code>timeout</code> (انظر فقرة البنية العامة)، ولم يكن أي من [[Ruby/IO|مجريات د/خ]] كائن <code>IO</code> جاهزاً خلال <code>timeout</code> ثانية.
+*التابع <code>[[Ruby/IO/read|read]]</code>: يقرأ ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج.
 ==مصادر==
-*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-readlines قسم  التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.]
+*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-readlines قسم التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.]