الفرق بين المراجعتين لصفحة: «Ruby/IO/readlines»
لا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) ط مراجعة وتدقيق. |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE: التابع <code>readlines | <noinclude>{{DISPLAYTITLE: التابع <code>IO.readlines</code> في روبي}}</noinclude> | ||
[[تصنيف: Ruby]] | [[تصنيف: Ruby]] | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
يقرأ التابع <code>readlines</code> | يقرأ التابع <code>readlines</code> ملفًا بأكمله سطرًا سطرًا ثم يعيد تلك الأسطر في [[Ruby/Array|مصفوفة]]. | ||
إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|جدول Hash]]، فسيمثِّل الوسيط المسمى (keyword argument) المراد فتحه. | |||
إن كان الوسيط الأخير عبارة عن [[Ruby/Hash| | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args]) → array | <syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args]) → array | ||
| سطر 19: | سطر 12: | ||
==المعاملات== | ==المعاملات== | ||
===<code>name</code>=== | ===<code>name</code>=== | ||
اسم الملف | اسم الملف المراد قراءة أسطره ووضعها في مصفوفة. | ||
===<code>sep</code>=== | ===<code>sep</code>=== | ||
الفاصل الذي يفصل بين الأسطر. القيمة الافتراضية هي: <code>/$</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>=== | ===<code>open_args</code>=== | ||
مصفوفة | [[Ruby/Array|مصفوفة]] أو <nowiki/>[[Ruby/Hash|جدول Hash]] يوفر خيارات الفتح. اطلع على صفحة التابع <code>[[Ruby/IO/read|read]]</code> لمزيد من التفاصيل حول المعامل <code>open_args</code>. | ||
===<code>limit</code>=== | ===<code>limit</code>=== | ||
الحد الأقصى للأسطر المقروءة | الحد الأقصى للأسطر المقروءة. | ||
==القيمة | ==القيمة المعادة== | ||
تعاد [[Ruby/Array|مصفوفة]] يحوي كل عنصر من عناصرها سطرًا من أسطر الملف ذي الاسم <code>name</code>. | |||
==أمثلة== | ==أمثلة== | ||
| سطر 35: | سطر 33: | ||
b = IO.readlines("testfile", chomp: true) | b = IO.readlines("testfile", chomp: true) | ||
b[0] #=> "This is line one"</syntaxhighlight> | b[0] #=> "This is line one"</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* | *التابع [[Ruby/IO/foreach|<code>foreach</code>]]: ينفذ الكتلة المعطاة على كل سطر في منفذ مجرى د/خ المسمى. | ||
*التابع <code>[[Ruby/IO/read|read]]</code>: يقرأ ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/IO.html#method-c-readlines قسم | *[http://ruby-doc.org/core-2.5.1/IO.html#method-c-readlines قسم التابع readlines في الصنف IO في توثيق روبي الرسمي.] | ||
المراجعة الحالية بتاريخ 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: يقرأ ملفًا محددًا بعد فتحه ثم يغلقه قبل إعادة الناتج.