الفرق بين المراجعتين لصفحة: «Ruby/String/center»
جميل-بيلوني (نقاش | مساهمات) إنشاء الصفحة. هذه الصفحة من مساهمات "كريم حبال". |
جميل-بيلوني (نقاش | مساهمات) |
||
(1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
سطر 3: | سطر 3: | ||
[[تصنيف: Ruby Method]] | [[تصنيف: Ruby Method]] | ||
[[تصنيف: Ruby String]] | [[تصنيف: Ruby String]] | ||
يعيد التابع <code>center</code> | يعيد التابع <code>center</code> سلسلة نصية جديدة بطول محدَّد مع وضع السلسلة النصية المعطاة في وسطها وحشو طرفيها بمحارف معيَّنة. | ||
==البنية العامة== | ==البنية العامة== | ||
<syntaxhighlight lang="ruby">center(width, padstr=' ') → new_str</syntaxhighlight> | <syntaxhighlight lang="ruby">center(width, padstr=' ') → new_str</syntaxhighlight> | ||
== المعاملات == | |||
=== <code>integer</code> === | |||
عدد صحيح موجب يمثل طول السلسلة النصية الجديدة. | |||
=== <code>padstr</code> === | |||
سلسلة نصية تمثل الحاشية التي ستوضع على طرفي السلسلة النصية المعطاة. | |||
==القيمة المعادة== | ==القيمة المعادة== | ||
تُعاد سلسلة نصية جديدة طولها العدد الصحيح <code>integer</code>، ويتوضع في وسطها السلسلة النصية المُعطاة وعلى طرفيها السلسلة <code>padstr</code>. ستُعاد السلسلة النصية المعطاة نفسها إذا كان العدد <code>integer</code> أقل من طولها. | |||
==أمثلة== | ==أمثلة== | ||
سطر 15: | سطر 23: | ||
"hello".center(20) #=> " hello " | "hello".center(20) #=> " hello " | ||
"hello".center(20, '123') #=> "1231231hello12312312"</syntaxhighlight> | "hello".center(20, '123') #=> "1231231hello12312312"</syntaxhighlight> | ||
==انظر | ==انظر أيضًا== | ||
* التابع <code>[[Ruby/String/bytesize|bytesize]]</code>: يعيد طول السلسلة النصية التي استدعيت معه بالبايت. | |||
* التابع <code>[[Ruby/String/ljust|ljust]]</code>: يعيد سلسلة جديدة بطول محدَّد تحتوي في يسارها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة. | |||
* التابع <code>[[Ruby/String/rjust|rjust]]</code>: يعيد سلسلة جديدة بطول محدَّد تحتوي في يمينها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة. | |||
==مصادر== | ==مصادر== | ||
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-center قسم التابع center في الصنف String في توثيق روبي الرسمي.] | *[http://ruby-doc.org/core-2.5.1/String.html#method-i-center قسم التابع center في الصنف String في توثيق روبي الرسمي.] |
المراجعة الحالية بتاريخ 06:05، 15 ديسمبر 2018
يعيد التابع center
سلسلة نصية جديدة بطول محدَّد مع وضع السلسلة النصية المعطاة في وسطها وحشو طرفيها بمحارف معيَّنة.
البنية العامة
center(width, padstr=' ') → new_str
المعاملات
integer
عدد صحيح موجب يمثل طول السلسلة النصية الجديدة.
padstr
سلسلة نصية تمثل الحاشية التي ستوضع على طرفي السلسلة النصية المعطاة.
القيمة المعادة
تُعاد سلسلة نصية جديدة طولها العدد الصحيح integer
، ويتوضع في وسطها السلسلة النصية المُعطاة وعلى طرفيها السلسلة padstr
. ستُعاد السلسلة النصية المعطاة نفسها إذا كان العدد integer
أقل من طولها.
أمثلة
مثال على استخدام التابع center
:
"hello".center(4) #=> "hello"
"hello".center(20) #=> " hello "
"hello".center(20, '123') #=> "1231231hello12312312"
انظر أيضًا
- التابع
bytesize
: يعيد طول السلسلة النصية التي استدعيت معه بالبايت. - التابع
ljust
: يعيد سلسلة جديدة بطول محدَّد تحتوي في يسارها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة. - التابع
rjust
: يعيد سلسلة جديدة بطول محدَّد تحتوي في يمينها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة.