This class provides advanced methods on Strings. It is ideally used with
using StringTools
and then acts as an extension
to the String
class.
If the first argument to any of the methods is null, the result is unspecified.
Static methods
staticisSpace (s:String, pos:Int):Bool
Tells if the character in the string s
at position pos
is a space.
A character is considered to be a space character if its character code is 9,10,11,12,13 or 32.
If s
is the empty String ""
, or if pos is not a valid position within
s
, the result is false.
staticlpad (s:String, c:String, l:Int):String
Concatenates c
to s
until s.length
is at least l
.
If c
is the empty String ""
or if l
does not exceed s.length
,
s
is returned unchanged.
If c.length
is 1, the resulting String length is exactly l
.
Otherwise the length may exceed l
.
If c
is null, the result is unspecified.
staticltrim (s:String):String
Removes leading space characters of s
.
This function internally calls isSpace()
to decide which characters to
remove.
If s
is the empty String ""
or consists only of space characters, the
result is the empty String ""
.
staticreplace (s:String, sub:String, by:String):String
Replace all occurrences of the String sub
in the String s
by the
String by
.
If sub
is the empty String ""
, by
is inserted after each character
of s
. If by
is also the empty String ""
, s
remains unchanged.
This is a convenience function for s.split(sub).join(by)
.
If sub
or by
are null, the result is unspecified.