الفرق بين المراجعتين لصفحة: «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: يُعيد محارف السلسلة النصية على شكل مصفوفة.