الفرق بين المراجعتين ل"Ruby/String/lines"
اذهب إلى التنقل
اذهب إلى البحث
جميل-بيلوني (نقاش | مساهمات) (إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال".) |
جميل-بيلوني (نقاش | مساهمات) (إضافة المحتوى) |
||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
− | + | يُعيد التابع <code>lines</code> مصفوفة كل عنصر منها سطرًا من سطور السلسلة النصية المعطاة. هذا التابع هو اختصار للاستدعاء <code>str.each_line.to_a</code>. | |
+ | |||
+ | في حال إعطاء كتلة، والتي هي الشكل المهمل من هذا التابع، فسيسلك هذا التابع نفس سلوك التابع <code>[[Ruby/String/each line|each_line]]</code> تمامًا. | ||
+ | |||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">lines(separator=$/) → an_array</syntaxhighlight> | <syntaxhighlight lang="ruby">lines(separator=$/) → an_array</syntaxhighlight> | ||
+ | |||
+ | == المعاملات == | ||
+ | |||
+ | === <code>separator</code> === | ||
+ | الفاصل الذي سيُّقسِّم محتوى السلسلة النصية إلى أجزاء لوضع كلٍّ منها في عنصر من عناصر المصفوفة المعادة. القيمة الافتراضية هي: <code>/$</code> (الفاصل السطري). | ||
==القيمة المعادة== | ==القيمة المعادة== | ||
− | + | تُعاد [[Ruby/Array|مصفوفة]] تحوي عناصرها أجزاء السلسلة النصية المعطاة المفصولة عن بعضها بالفاصل <code>separator</code>. | |
+ | |||
+ | == أمثلة == | ||
+ | أمثلة على استعمال التابع <code>lines</code>:<syntaxhighlight lang="ruby"> | ||
+ | a= "book and pen and pencil" | ||
+ | a.each_line("and").to_a #=> ["book and", " pen and", " pencil"] | ||
+ | |||
+ | b="how \n are \n you \n dad" | ||
+ | b.each_line.to_a #=>["how \n", " are \n", " you \n", " dad"] | ||
+ | |||
+ | </syntaxhighlight> | ||
− | ==انظر | + | ==انظر أيضًا== |
+ | * التابع <code>[[Ruby/String/bytes|bytes]]</code>: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. | ||
+ | * التابع <code>[[Ruby/String/chars|chars]]</code>: يُعيد محارف السلسلة النصية على شكل مصفوفة. | ||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-lines قسم التابع lines في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-lines قسم التابع lines في الصنف String في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 12:45، 12 ديسمبر 2018
يُعيد التابع lines
مصفوفة كل عنصر منها سطرًا من سطور السلسلة النصية المعطاة. هذا التابع هو اختصار للاستدعاء str.each_line.to_a
.
في حال إعطاء كتلة، والتي هي الشكل المهمل من هذا التابع، فسيسلك هذا التابع نفس سلوك التابع each_line
تمامًا.
البنية العامة
lines(separator=$/) → an_array
المعاملات
separator
الفاصل الذي سيُّقسِّم محتوى السلسلة النصية إلى أجزاء لوضع كلٍّ منها في عنصر من عناصر المصفوفة المعادة. القيمة الافتراضية هي: /$
(الفاصل السطري).
القيمة المعادة
تُعاد مصفوفة تحوي عناصرها أجزاء السلسلة النصية المعطاة المفصولة عن بعضها بالفاصل separator
.
أمثلة
أمثلة على استعمال التابع lines
:
a= "book and pen and pencil"
a.each_line("and").to_a #=> ["book and", " pen and", " pencil"]
b="how \n are \n you \n dad"
b.each_line.to_a #=>["how \n", " are \n", " you \n", " dad"]
انظر أيضًا
- التابع
bytes
: يُعيد البايتات المقابلة لمحارف السلسلة النصية في مصفوفة. - التابع
chars
: يُعيد محارف السلسلة النصية على شكل مصفوفة.