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