الفرق بين المراجعتين ل"Ruby/IO/readlines"
اذهب إلى التنقل
اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>readlines</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude> تصنيف: Ruby تصني...') |
|||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby IO]] | [[تصنيف: Ruby IO]] | ||
− | يقرأ التابع <code>readlines</code> كامل الملف المحدد | + | يقرأ التابع <code>readlines</code> كامل الملف المحدد بالوسيط <code>name</code> (انظر فقرة البنية العامة) سطرًا سطرًا، ويعيد تلك السطور في [[Ruby/Array|مصفوفة]]. |
− | |||
+ | تُفصل السطور بالوسيط <code>sep</code>. | ||
إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|قاموس]]، فسيتم فتح الوسيط المسمى (keyword argument). | إن كان الوسيط الأخير عبارة عن [[Ruby/Hash|قاموس]]، فسيتم فتح الوسيط المسمى (keyword argument). | ||
− | خيارات getline | + | == خيارات getline == |
− | + | يقبل [[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>[[Ruby/IO/read| | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args]) → array | <syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args]) → array | ||
سطر 28: | سطر 22: | ||
===<code>sep</code>=== | ===<code>sep</code>=== | ||
فاصل | فاصل | ||
− | |||
===<code>open_args</code>=== | ===<code>open_args</code>=== | ||
مصفوفة توفر خيارات الفتح | مصفوفة توفر خيارات الفتح | ||
===<code>limit</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" | a[0] #=> "This is line one\n" | ||
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> | ||
==انظر أيضا== | ==انظر أيضا== | ||
− | * التابع <code>[[Ruby/IO/read|read]]</code>: يفتح التابع <code>read</code> | + | *التابع <code>[[Ruby/IO/read|read]]</code>: يفتح التابع <code>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 في توثيق روبي الرسمي.] |
مراجعة 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
الملف المحدد.