عرض مصدر Ruby/String/ljust

<noinclude>{{DISPLAYTITLE:التابع <code>String.ljust</code> في روبي}}</noinclude>
[[تصنيف: Ruby]]
[[تصنيف: Ruby Method]]
[[تصنيف: Ruby String]]
يعيد التابع <code>ljust</code> سلسلة جديدة بطول محدَّد تحتوي في يسارها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة.

يعيد التابع السلسلة النصية نفسها إذا كان العدد integer أقل من طول السلسلة.

==البنية العامة==
<syntaxhighlight lang="ruby">ljust(integer, padstr=' ') → new_str</syntaxhighlight>

== المعاملات ==

=== <code>integer</code> ===
عدد صحيح موجب يمثل طول السلسلة النصية الجديدة.

=== <code>padstr</code> ===
السلسلة النصية التي ستوضع حشوةً في الفراغ الذي يلي السلسلة النصية المعطاة في السلسلة الجديدة.

==القيمة المعادة==
تُعاد سلسلة نصية جديدة طولها العدد الصحيح <code>integer</code>، وتحتوي في يسارها على السلسلة النصية المُعطاة ثم ستملأ قيمة المعامل <code>padstr</code> الحجم المتبقي الذي يليها. 

تُعاد السلسلة النصية نفسها إذا كان الحجم <code>integer</code> أقل من طول السلسلة.

==أمثلة==
مثال على استعمال التابع <code>ljust</code>:
<syntaxhighlight lang="ruby">"hello".ljust(4)            #=> "hello"
"hello".ljust(20)           #=> "hello               "
"hello".ljust(20, '1234')   #=> "hello123412341234123"</syntaxhighlight>

==انظر أيضًا==
* التابع <code>[[Ruby/String/center|center]]</code>: يعيد سلسلة نصية جديدة بطول محدَّد مع وضع السلسلة النصية المعطاة في وسطها وحشو طرفيها بمحارف معيَّنة.
* التابع <code>[[Ruby/String/lstrip|lstrip]]</code>: يعيد نسخة عن السلسلة النصية مع حذف المسافة البيضاء في بادئة السلسلة.

==مصادر==
*[http://ruby-doc.org/core-2.5.1/String.html#method-i-ljust قسم التابع ‎ljust في الصنف String في توثيق روبي الرسمي.]