الفرق بين المراجعتين ل"Ruby/IO/readlines"

من موسوعة حسوب
< Ruby‏ | IO
اذهب إلى التنقل اذهب إلى البحث
(أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE: التابع <code>readlines‎</code> الخاص بالصنف <code>IO</code> في روبي}}</noinclude> تصنيف: Ruby تصني...')
 
سطر 3: سطر 3:
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby Method]]
 
[[تصنيف: Ruby IO]]
 
[[تصنيف: 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).
 
إن كان الوسيط الأخير عبارة عن [[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
 
<syntaxhighlight lang="ruby">readlines(name, sep=$/ [, getline_args, open_args])  → array
سطر 28: سطر 22:
 
===<code>sep‎</code>===
 
===<code>sep‎</code>===
 
فاصل
 
فاصل
===<code>getline_args‎</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>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‎ في توثيق روبي الرسمي.]
 
*[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 الملف المحدد.

مصادر