StringTools
PadLeft
pad a string out to a given width on the left
PadRight
pad a string on the right to a given width
Center
centre a string in a given width
Calling Sequence
Parameters
Description
Examples
PadLeft( s, width, padchar )
PadRight( s, width, padchar )
Center( s, width, padchar )
s
-
Maple string; string to be padded
width
non-negative integer; width of the resulting string
padchar
(optional) pad character to use
The PadLeft(s, width) command adds spaces to the left of the string s to produce a string of length equal to width. If width is less than or equal to the length of s, then s is returned unchanged.
The PadRight(s, width) command adds spaces to the right of the string s to produce a string of length width. If width is less than or equal to the length of s, then s is returned unchanged.
The optional padchar argument can be used to specify that a character other than the space be used to pad the string.
The Center(s, width) command adds spaces to both ends of the string s to produce a string of length width. If width - length(s) is even, then an equal number of spaces are added to the left and right ends of s. If width - length(s) is odd, then the extra space is added to the left of s.
The StringTools[TrimLeft], StringTools[TrimRight] and StringTools[Trim] commands are approximate inverses of PadLeft, PadRight and Center, respectively.
All of the StringTools package commands treat strings as (null-terminated) sequences of 8-bit (ASCII) characters. Thus, there is no support for multibyte character encodings, such as unicode encodings.
withStringTools:
PadLeftfoo,2
foo
PadLeftfoo,3
PadLeftfoo,4
PadLeftfoo,5
PadLeftfoo,6
PadRightfoo,5
PadRightfoo,6
Centerfoo,5
Centerfoo,6
PadLeftfoo,8,x
xxxxxfoo
PadRightfoo,8,x
fooxxxxx
Centerfoo,8,x
xxxfooxx
The Trim* procedures are approximate inverses to the Pad* and Center procedures.
TrimLeftPadLeftfoo,17
TrimRightPadRightfoo,17
TrimCenterfoo,17
The TrimLeft procedure is not quite an inverse of PadLeft, however.
TrimLeftPadLeft foo,17
Similar remarks apply to TrimRight and Trim.
See Also
string
StringTools[IsSpace]
StringTools[Trim]
Download Help Document