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

مراجعة 19:07، 13 نوفمبر 2018

يقرأ التابع readlines كل الأسطر الموجودة في مجرى د/خ، ثم يعيدها في مصفوفة. يتم فصل الأسطر بالوسيط الاختياري sep (انظر فقرة البنية العامة).

إن كان الوسيط sep يساوي nil، فسسيُعاد بقية المجرى كتسجيلة (record) واحدة. وإن كان الوسيط الأول عددًا صحيحًا، أو إن أُعطي الوسيط الاختياري الثاني، فلن تكون السلسلة النصية المعادة أطول من القيمة المحددة من حيث عدد البايتات.

يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء IOError.

راجع صفحة readlines لمزيد من التفاصيل حول getline_args.

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

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

المعاملات

`sep‎`

فاصل

`limit‎`

عدد صحيح

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

يعيد التابع readlines كل الأسطر الموجودة في مجرى د/خ على شكل مصفوفة.

أمثلة

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

f = File.new("testfile")
f.readlines[0]   #=> "This is line one\n"
f = File.new("testfile", chomp: true)
f.readlines[0]   #=> "This is line one"‎

انظر أيضا

التابع readline: يقرأ سطرًا كما يفعل التابع IO#gets، إلا أنه يُطلق الاستثناء EOFError عند نهاية الملف.
التابع readpartial: يقرأ maxlen بايتًا على الأكثر من مجرى د/خ.

مصادر

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

@@ سطر 3: / سطر 3: @@
 [[تصنيف: Ruby Method]]
 [[تصنيف: Ruby IO]]
-يقرأ التابع <code>readlines</code> كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]] <code>ios</code>، ثم يعيدها في [[Ruby/Array|مصفوفة]]. يتم فصل الأسطر بالوسيط الاختياري <code>sep</code> (انظر فقرة البنية العامة). إن كان الوسيط <code>sep</code> يساوي <code>nil</code>، فسسيُعاد بقية المجرى كتسجيلة (record) واحدة. إن كان الوسيط الأول عددًا صحيحًا، أو إن أعطي الوسيط الاختياري الثاني، فلن تكون [[Ruby/String|السلسلة النصية]] المعادة أطول من حيث عدد البايتات من القيمة المحددة. يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء <code>IOError</code>.
+يقرأ التابع <code>readlines</code> كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]]، ثم يعيدها في [[Ruby/Array|مصفوفة]]. يتم فصل الأسطر بالوسيط الاختياري <code>sep</code> (انظر فقرة البنية العامة).
+إن كان الوسيط <code>sep</code> يساوي <code>nil</code>، فسسيُعاد بقية المجرى كتسجيلة (record) واحدة. وإن كان الوسيط الأول عددًا صحيحًا، أو إن أُعطي الوسيط الاختياري الثاني، فلن تكون [[Ruby/String|السلسلة النصية]] المعادة أطول من القيمة المحددة من حيث عدد البايتات.
+يجب أن يكون المجرى مفتوحًا في وضعية القراءة أو سيُطلق استثناء <code>IOError</code>.
-راجع صفحة <code>[[Ruby/IO/readlines|::readlines]]</code> لمزيد من التفاصيل حول getline_args.
+راجع صفحة <code>[[Ruby/IO/readlines|readlines]]</code> لمزيد من التفاصيل حول <code>getline_args</code>.
 ==البنية العامة==
 <syntaxhighlight lang="ruby">readlines(sep=$/ [, getline_args])  → array
@@ سطر 15: / سطر 17: @@
 ===<code>sep‎</code>===
 فاصل
-===<code>getline_args‎</code>===
 ===<code>limit‎</code>===
-عدد صحيح يمثل الحد الأٌقصى
+عدد صحيح
 ==القيمة المُعادة==
+يعيد التابع <code>readlines</code> كل الأسطر الموجودة في [[Ruby/IO|مجرى د/خ]] على شكل [[Ruby/Array|مصفوفة]].
 ==أمثلة==
 مثال على استخدام التابع <code>readlines‎</code>:
@@ سطر 27: / سطر 30: @@
 ==انظر أيضا==
 * التابع <code>[[Ruby/IO/readline|readline]]</code>: يقرأ  سطرًا كما يفعل التابع <code>IO#gets</code>، إلا أنه يُطلق الاستثناء <code>EOFError</code> عند نهاية الملف.
-* التابع <code>[[Ruby/IO/readpartial|readpartial]]</code>: يقرأ  <code>maxlen</code> (انظر فقرة البنية العامة) بايتًا على الأكثر من [[Ruby/IO|مجرى د/خ]]. لا يقوم  بالتعطيل إلا في حال لم يكن في [[Ruby/IO|مجرى د/خ]] <code>ios</code> أي بيانات متوفرة آنيًا. لن يقوم بالتعطيل في حالة توفر بعض البيانات.
+* التابع <code>[[Ruby/IO/readpartial|readpartial]]</code>: يقرأ  <code>maxlen</code> بايتًا على الأكثر من [[Ruby/IO|مجرى د/خ]].
 ==مصادر==
 *[http://ruby-doc.org/core-2.5.1/IO.html#method-i-readlines قسم  التابع readlines‎ في الصنف IO‎ في توثيق روبي الرسمي.]