pad_right() [4/4]

template<typename char_t >

ustring xtd::ustring::pad_right ( size_t  total_width, char_t  padding_char  ) const

inline

Left-aligns the characters in this string, padding with spaces on the right for a specified total length.

Parameters

totalWidth	The number of characters in the resulting string, equal to the number of original characters plus any additional padding characters.
paddingChar	An unicode padding character.

Returns

A new string that is equivalent to the specified string, but left-aligned and padded on the tight with as many spaces as needed to create a length of totalWidth. Or, if totalWidth is less than the length of the specified string, a new string object that is identical to the specified string.

Remarks

An unicode space is defined as hexadecimal 0x20.

The xtd::ustring::pad_right method pads the end of the returned string. This means that, when used with right-to-left languages, it pads the left portion of the string..