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

مراجعة 00:42، 13 نوفمبر 2018

يقرأ التابع readlines كامل الملف المحدد بالوسيط name (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في مصفوفة.

تُفصل السطور بالوسيط sep.

إن كان الوسيط الأخير عبارة عن قاموس، فسيتم فتح الوسيط المسمى (keyword argument).

خيارات getline

يقبل قاموس الخيارات مفتاحًا وحيدا، وهو:

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

وانظر أيضا صفحة read لمزيد من التفاصيل حول الوسيط open_args.

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

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‎`

فاصل

`open_args‎`

مصفوفة توفر خيارات الفتح

`limit‎`

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

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

يعيد التابع readlinesأسطر الملف المحدد في مصفوفة.

أمثلة

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

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

انظر أيضا

التابع read: يفتح التابع read الملف المحدد.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يقرأ التابع <code>readlines</code> كامل الملف المحدد بواسطة <code>name</code> (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في [[Ruby/Array|مصفوفة]]. تُفصل السطو بواسطة <code>sep</code>.
+يقرأ التابع <code>readlines</code> كامل الملف المحدد بالوسيط <code>name</code> (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في [[Ruby/Array|مصفوفة]].
+تُفصل السطور بالوسيط <code>sep</code>.
 إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|قاموس]]، فسيتم فتح الوسيط المسمى (keyword argument).
-خيارات getline
+== خيارات getline ==
-<code>[[Ruby//readlines-label-Options+for+getline|¶]]</code> <code>[[Ruby//top|↑]]</code>
+يقبل [[Ruby/Hash|قاموس]] الخيارات مفتاحًا وحيدا، وهو:
+* <code>‎:chomp</code> - عندما يُعطى للوسيط المسمى الاختياري <code>chomp</code> قيمة صحيحة (true value)، فستتم إزالة ‎<code>\n</code> و ‎<code>\r</code> و ‎<code>\r\n</code> من نهاية كل سطر.
-يقبل [[Ruby/Hash|قاموس]] الخيارات المفاتيح التالية:
+وانظر أيضا صفحة <code>[[Ruby/IO/read|read]]</code> لمزيد من التفاصيل حول الوسيط <code>open_args</code>.
-‎: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
@@ سطر 28: / سطر 22: @@
 ===<code>sep‎</code>===
 فاصل
-===<code>getline_args‎</code>===
 ===<code>open_args‎</code>===
 مصفوفة توفر خيارات الفتح
 ===<code>limit‎</code>===
+الحد الأقصى للأسطر المقروءة
 ==القيمة المُعادة==
+يعيد التابع <code>readlines</code>أسطر الملف المحدد في [[Ruby/Array|مصفوفة]].
 ==أمثلة==
-مثال على استخدام التابع <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> أن يُغلق الملف قبل العودة.
+*التابع <code>[[Ruby/IO/read|read]]</code>: يفتح التابع <code>read</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> ثانية.
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/IO.html#method-c-readlines قسم  التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.]