التابع String.ljust في روبي

من موسوعة حسوب
< Ruby‏ | String

يعيد التابع ljust سلسلة جديدة بطول محدَّد تحتوي في يسارها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة.

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

البنية العامة

ljust(integer, padstr=' ')  new_str

المعاملات

integer

عدد صحيح موجب يمثل طول السلسلة النصية الجديدة.

padstr

السلسلة النصية التي ستوضع حشوةً في الفراغ الذي يلي السلسلة النصية المعطاة في السلسلة الجديدة.

القيمة المعادة

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

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

أمثلة

مثال على استعمال التابع ljust:

"hello".ljust(4)            #=> "hello"
"hello".ljust(20)           #=> "hello               "
"hello".ljust(20, '1234')   #=> "hello123412341234123"

انظر أيضًا

  • التابع center: يعيد سلسلة نصية جديدة بطول محدَّد مع وضع السلسلة النصية المعطاة في وسطها وحشو طرفيها بمحارف معيَّنة.
  • التابع lstrip: يعيد نسخة عن السلسلة النصية مع حذف المسافة البيضاء في بادئة السلسلة.
  • التابع rjust: يعيد سلسلة جديدة بطول محدَّد تحتوي في يمينها على السلسلة النصية المُعطاة مع حشو الحجم المتبقي بمحارف محدَّدة.

مصادر