| java.lang.Object
 com.sshtools.daemon.util.StringUtil
| StringUtil | | public class StringUtil (Code) | | The sole instance of this class provides several convienience methods for
string manipulation such as substring replacement or character repetition.
author:
Manfred Duchrow
version:
2.0 |
| Method Summary | |
| public String[] | allParts(String text, String delimiters)
Returns an array of substrings of the given text. | | public String[] | allSubstrings(String text, String separator)
Returns the given text split up into an array of strings, at the
occurrances of the separator string. | | public String[] | append(String[] strings, String string)
Returns the given string array extended by one element that hold the
specified string. | | public String[] | append(String[] strings, String[] appendStrings)
Returns an array of strings that contains all strings given by the first
and second string array. | | public String[] | appendIfNotThere(String[] strings, String appendString)
Returns an array of strings that contains all strings given in the first
plus the specified string to append, if it is not already in the given
array. | | public String[] | appendIfNotThere(String[] strings, String[] appendStrings)
Returns an array of strings that contains all strings given in the first
plus all strings of the second array that are not already in the first
array. | | public Map | asMap(String str)
Returns a new map object that contains all key-value pairs of the
specified string. | | public Map | asMap(String str, String elementSeparator)
Returns a new map object that contains all key-value pairs of the
specified string. | | public Map | asMap(String str, String elementSeparator, String keyValueSeparator)
Returns a new map object that contains all key-value pairs of the
specified string. | | public Properties | asProperties(String str)
Adds all key-value pairs of the given string to a new properties object. | | public String | asString(String[] strings, String separator)
Returns a string that contains all given strings concatenated and
separated by the specified separator. | | public String | asString(String[] strings)
Returns a string that contains all given strings concatenated and
separated by comma. | | public String | center(String str, int len)
Returns the given string filled (on the right and right) up to the
specified length with spaces. | | public String | centerCh(String str, int len, char ch)
Returns the given string filled equally left and right up to the
specified length with the given character. | | protected void | collectParts(List list, StringTokenizer tokenizer)
| | protected void | collectParts(List list, StringTokenizer tokenizer, String delimiter)
| | public boolean | contains(String[] strArray, String searchStr, boolean ignoreCase)
Returns whether or not the specified string can be found in the given
string array.
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed)
Parameters:
ignoreCase - Defines whether or not the comparison iscase-sensitive. | | public boolean | contains(String[] strArray, StringPattern pattern)
Returns whether or not a string can be found in the given string array
that matches the specified string pattern. | | public boolean | contains(String[] strArray, String searchStr)
Returns whether or not the specified string can be found in the given
string array. | | public boolean | containsIgnoreCase(String[] strArray, String searchStr)
Returns whether or not the specified string can be found in the given
string array. | | public String[] | copyFrom(String[] from, int start)
Returns all elements of string array from in a new array from
index start up to the end. | | public String[] | copyFrom(String[] from, int start, int end)
Returns all elements of string array from in a new array from
index start up to index end (inclusive). | | public static StringUtil | current()
Returns the one and only instance of this class. | | public String | cutHead(String text, String separator)
Returns the portion of the given string that stands after the last
occurance of the specified separator. | | public String | cutTail(String text, String separator)
Returns the portion of the given string that comes before the last
occurance of the specified separator. | | public String | getDelimitedSubstring(String text, String startDelimiter, String endDelimiter)
Returns the first substring that is enclosed by the specified
delimiters. | | public String | getDelimitedSubstring(String text, String delimiter)
Returns the first substring that is enclosed by the specified delimiter. | | public int | indexOf(String[] strArray, StringPattern pattern)
Returns the index of the first string in the given string array that
matches the specified string pattern. | | public int | indexOf(String[] strArray, String searchStr)
Returns the index of the specified string in the given string array. | | public int | indexOfIgnoreCase(String[] strArray, String searchStr)
Returns the index of the specified string in the given string array. | | protected int | indexOfString(String[] strArray, String searchStr, boolean ignoreCase)
| | public String | leftPad(String str, int len)
Returns the given string filled (on the left) up to the specified length
with spaces. | | public String | leftPad(int value, int len)
Returns the given integer as string filled (on the left) up to the
specified length with zeroes. | | public String | leftPadCh(String str, int len, char ch)
Returns the given string filled (on the left) up to the specified length
with the given character. | | public String | leftPadCh(int value, int len, char fillChar)
Returns the given integer as string filled (on the left) up to the
specified length with the given fill character. | | protected String | padCh(String str, int len, char ch, boolean left)
| | public String[] | parts(String text, String delimiters)
Returns an array of substrings of the given text. | | protected String[] | parts(String text, String delimiters, boolean all)
Returns an array of substrings of the given text. | | public String | prefix(String str, String separator)
Returns the substring of the given string that comes before the first
occurance of the specified separator. | | protected String | prefix(String str, String separator, boolean returnNull)
Returns the substring of the given string that comes before the first
occurance of the specified separator. | | public String[] | remove(String[] strings, String[] removeStrings)
Removes all string of the second array from the first array. | | public String[] | remove(String[] strings, String removeString)
Removes the given string from the specified string array. | | protected String[] | removeFromStringArray(String[] strings, String[] removeStrings)
Removes the given strings from the array. | | public String[] | removeNull(String[] strings)
Removes all null values from the given string array. | | public String | repeat(char ch, int count)
Returns a string with size of count and all characters initialized with
ch. | | public String | replaceAll(String sourceStr, String oldSubStr, String newSubStr)
Returns the given string with all found oldSubStr replaced by newSubStr. | | public String | reverse(String str)
Returns a string that contains all characters of the given string in
reverse order. | | public String | rightPad(String str, int len)
Returns the given string filled (on the right) up to the specified
length with spaces. | | public String | rightPad(int value, int len)
Returns the given integer as string filled (on the right) up to the
specified length with spaces. | | public String | rightPadCh(String str, int len, char ch)
Returns the given string filled (on the right) up to the specified
length with the given character. | | public String | rightPadCh(int value, int len, char fillChar)
Returns the given integer as string filled (on the right) up to the
specified length with the given character. | | public String[] | splitNameValue(String str, String separator)
Returns a string array with two elements where the first is the
attribute name and the second is the attribute value. | | public String | stackTrace(Throwable throwable)
Prints the stack trace of the specified throwable to a string and
returns it. | | public String | startingFrom(String str, String separator)
Returns the substring of the given string that comes after the first
occurance of the specified separator. | | public String[] | substrings(String text, String separator)
Returns the given text split up into an array of strings, at the
occurrances of the separator string. | | protected String[] | substrings(String text, String separator, boolean all)
Returns the given text split up into an array of strings, at the
occurrances of the separator string. | | public String | suffix(String str, String separator)
Returns the substring of the given string that comes after the first
occurance of the specified separator. | | protected String | suffix(String str, String separator, boolean returnNull)
Returns the substring of the given string that comes after the first
occurance of the specified separator. | | public Map | toMap(String str, String elementSeparator, String keyValueSeparator, Map map)
Returns the given map with new entries from the specified String. | | public Map | toMap(String str, String elementSeparator, Map map)
Returns the given map object with all key-value pairs of the specified
string added to it. | | public Map | toMap(String str, Map map)
Adds all key-value pairs of the given string to the specified map. | | public Properties | toProperties(String str, Properties properties)
Adds all key-value pairs of the given string to the specified
properties. | | protected String | trimSeparator(String text, String separator)
Cuts off all leading and trailing occurences of separator in text. | | public String | upTo(String str, String separator)
Returns the substring of the given string that comes before the first
occurance of the specified separator. | | public String[] | words(String text)
Returns an array of substrings of the given text. |
| CH_CR | | final public static char CH_CR(Code) | | Constant for the carriage return character
|
| CH_NEWLINE | | final public static char CH_NEWLINE(Code) | | Constant for the new line character
|
| CH_SPACE | | final public static char CH_SPACE(Code) | | Constant for the space character
|
| CH_TAB | | final public static char CH_TAB(Code) | | Constant for the tabulator character
|
| STR_CR | | final public static String STR_CR(Code) | | Constant for the String representation of the carriage return character
|
| STR_NEWLINE | | final public static String STR_NEWLINE(Code) | | Constant for the String representation of the new line character
|
| STR_SPACE | | final public static String STR_SPACE(Code) | | Constant for the String representation of the space character
|
| STR_TAB | | final public static String STR_TAB(Code) | | Constant for the String representation of the tabulator character
|
| allParts | | public String[] allParts(String text, String delimiters)(Code) | | Returns an array of substrings of the given text.
The separators between the substrings are the given delimiters. Each
character in the delimiter string is treated as a separator.
For each delimiter that is followed immediately by another delimiter an
empty string will be added to the result. There are no empty strings
added to the result for a delimiter at the very beginning of at the
very end.
Examples:
allParts( "/A/B//", "/" ) --> { "A", "B", "" }
allParts( "/A,B/C;D", ",;/" ) --> { "A", "B", "C", "D" }
allParts( "A/B,C/D", "," ) --> { "A/B", "C/D" }
Parameters:
text - The string that should be splitted into substrings
Parameters:
delimiters - All characters that should be recognized as aseparator or substrings An array of substrings of the given text
See Also: StringUtil.parts(String,String)
See Also: StringUtil.substrings(String,String)
See Also: StringUtil.allSubstrings(String,String) |
| allSubstrings | | public String[] allSubstrings(String text, String separator)(Code) | | Returns the given text split up into an array of strings, at the
occurrances of the separator string. In contrary to method allParts()
the separator is a one or many character sequence delimiter. That is,
only the exact sequence of the characters in separator identifies the
end of a substring. Subsequent occurences of separator are not skipped.
They are added as empty strings to the result.
Parameters:
text - The text to be split up
Parameters:
separator - The string that separates the substrings An array of substrings not containing any separator anymore
See Also: StringUtil.substrings(String,String)
See Also: StringUtil.parts(String,String)
See Also: StringUtil.allParts(String,String) |
| append | | public String[] append(String[] strings, String string)(Code) | | Returns the given string array extended by one element that hold the
specified string.
Parameters:
strings -
Parameters:
string - |
| append | | public String[] append(String[] strings, String[] appendStrings)(Code) | | Returns an array of strings that contains all strings given by the first
and second string array. The strings from the second array will be
added at the end of the first array.
Parameters:
strings - The array of string to which to append
Parameters:
appendStrings - The string to be appended to the first array |
| appendIfNotThere | | public String[] appendIfNotThere(String[] strings, String appendString)(Code) | | Returns an array of strings that contains all strings given in the first
plus the specified string to append, if it is not already in the given
array.
Parameters:
strings -
Parameters:
appendString - |
| appendIfNotThere | | public String[] appendIfNotThere(String[] strings, String[] appendStrings)(Code) | | Returns an array of strings that contains all strings given in the first
plus all strings of the second array that are not already in the first
array.
Parameters:
strings -
Parameters:
appendStrings - |
| asMap | | public Map asMap(String str)(Code) | | Returns a new map object that contains all key-value pairs of the
specified string.
The separator between the elements is assumed to be "," and "=" between
key and value.
Example:
"main=Fred,support1=John,support2=Stella,manager=Oscar"
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string with the list of key-value pairs |
| asMap | | public Map asMap(String str, String elementSeparator)(Code) | | Returns a new map object that contains all key-value pairs of the
specified string.
The separator between the keys and values is assumed to be "=".
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
elementSeparator - The separator between the elements of the list |
| asMap | | public Map asMap(String str, String elementSeparator, String keyValueSeparator)(Code) | | Returns a new map object that contains all key-value pairs of the
specified string.
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
elementSeparator - The separator between the elements of the list
Parameters:
keyValueSeparator - The separator between the keys and values |
| asProperties | | public Properties asProperties(String str)(Code) | | Adds all key-value pairs of the given string to a new properties object.
The separator between the elements is assumed to be "," and "=" between
key and value.
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs |
| asString | | public String asString(String[] strings, String separator)(Code) | | Returns a string that contains all given strings concatenated and
separated by the specified separator.
Parameters:
strings - The array of strings that should be concatenated
Parameters:
separator - The separator between the strings One string containing the concatenated strings separated byseparator |
| asString | | public String asString(String[] strings)(Code) | | Returns a string that contains all given strings concatenated and
separated by comma.
Parameters:
strings - The array of strings that should be concatenated One string containing the concatenated strings separated bycomma (",") |
| center | | public String center(String str, int len)(Code) | | Returns the given string filled (on the right and right) up to the
specified length with spaces.
Example: center( "Mike", 10 ) --> " Mike "
Parameters:
str -
Parameters:
len - |
| centerCh | | public String centerCh(String str, int len, char ch)(Code) | | Returns the given string filled equally left and right up to the
specified length with the given character.
Example: centerCh( "A", 5, '_' ) --> "__A__"
Example: centerCh( "XX", 7, '+' ) --> "++XX+++"
Parameters:
str -
Parameters:
len -
Parameters:
ch - |
| contains | | public boolean contains(String[] strArray, String searchStr, boolean ignoreCase)(Code) | | Returns whether or not the specified string can be found in the given
string array.
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed)
Parameters:
ignoreCase - Defines whether or not the comparison iscase-sensitive. true, if the specified array contains the given string |
| contains | | public boolean contains(String[] strArray, StringPattern pattern)(Code) | | Returns whether or not a string can be found in the given string array
that matches the specified string pattern.
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
pattern - The string pattern to match against in the array (nullallowed) true, if the specified array contains a string matching thepattern |
| contains | | public boolean contains(String[] strArray, String searchStr)(Code) | | Returns whether or not the specified string can be found in the given
string array. The comparison of the strings is case-sensitive!
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed) true, if the specified array contains the given string |
| containsIgnoreCase | | public boolean containsIgnoreCase(String[] strArray, String searchStr)(Code) | | Returns whether or not the specified string can be found in the given
string array. The comparison of the strings is case-insensitive!
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed) true, if the specified array contains the given string |
| copyFrom | | public String[] copyFrom(String[] from, int start)(Code) | | Returns all elements of string array from in a new array from
index start up to the end. If start index is larger than the array's
length, an empty array will be returned.
Parameters:
from - The string array the elements should be copied from
Parameters:
start - Index of the first element to copy |
| copyFrom | | public String[] copyFrom(String[] from, int start, int end)(Code) | | Returns all elements of string array from in a new array from
index start up to index end (inclusive). If end is larger than the last
valid index, it will be reduced to the last index. If end index is less
than start index, an empty array will be returned.
Parameters:
from - The string array the elements should be copied from
Parameters:
start - Index of the first element to copy
Parameters:
end - Index of last element to be copied |
| current | | public static StringUtil current()(Code) | | Returns the one and only instance of this class.
|
| cutHead | | public String cutHead(String text, String separator)(Code) | | Returns the portion of the given string that stands after the last
occurance of the specified separator.
If the separator could not be found in the given string, then the
string is returned unchanged.
Examples:
cutHead( "A/B/C", "/" ) ; // returns "C"
cutHead( "A/B/C", "," ) ; // returns "A/B/C"
Parameters:
text - The string from which to cut off the head
Parameters:
separator - The separator up to which to cut off the string without the separator and without the charactersbefore the separator
See Also: StringUtil.prefix(String,String)
See Also: StringUtil.cutTail(String,String)
See Also: StringUtil.suffix(String,String)
See Also: StringUtil.startingFrom(String,String)
See Also: StringUtil.upTo(String,String) |
| cutTail | | public String cutTail(String text, String separator)(Code) | | Returns the portion of the given string that comes before the last
occurance of the specified separator.
If the separator could not be found in the given string, then the
string is returned unchanged.
Examples:
cutTail( "A/B/C", "/" ) ; // returns "A/B"
cutTail( "A/B/C", "," ) ; // returns "A/B/C"
Parameters:
text - The string from which to cut off the tail
Parameters:
separator - The separator from where to cut off the string without the separator and without the charactersafter the separator
See Also: StringUtil.prefix(String,String)
See Also: StringUtil.suffix(String,String)
See Also: StringUtil.cutHead(String,String)
See Also: StringUtil.startingFrom(String,String)
See Also: StringUtil.upTo(String,String) |
| getDelimitedSubstring | | public String getDelimitedSubstring(String text, String startDelimiter, String endDelimiter)(Code) | | Returns the first substring that is enclosed by the specified
delimiters.
The delimiters are not included in the return string.
Example:
getDelimitedSubstring( "This {placeholder} belongs to me",
"{", "}" ) --> returns "placeholder"
Parameters:
text - The input string that contains the delimited part
Parameters:
startDelimiter - The start delimiter of the substring
Parameters:
endDelimiter - The end delimiter of the substring The substring or an empty string, if no delimiters are found. |
| getDelimitedSubstring | | public String getDelimitedSubstring(String text, String delimiter)(Code) | | Returns the first substring that is enclosed by the specified delimiter.
The delimiters are not included in the return string.
Example:
getDelimitedSubstring( "File 'text.txt' not found.", "'",
"'" ) --> returns "text.txt"
Parameters:
text - The input string that contains the delimited part
Parameters:
delimiter - The start and end delimiter of the substring The substring or an empty string, if no delimiters are found. |
| indexOf | | public int indexOf(String[] strArray, StringPattern pattern)(Code) | | Returns the index of the first string in the given string array that
matches the specified string pattern. If no string is found in the
array the result is -1.
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
pattern - The pattern the searched string must match The index of the matching string in the array or -1 if not found |
| indexOf | | public int indexOf(String[] strArray, String searchStr)(Code) | | Returns the index of the specified string in the given string array. It
returns the index of the first occurrence of the string. If the string
is not found in the array the result is -1. The comparison of the
strings is case-sensitive!
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed) The index of the string in the array or -1 if not found |
| indexOfIgnoreCase | | public int indexOfIgnoreCase(String[] strArray, String searchStr)(Code) | | Returns the index of the specified string in the given string array. It
returns the index of the first occurrence of the string. If the string
is not found in the array the result is -1. The comparison of the
strings is case-insensitive!
Parameters:
strArray - An array of string (may contain null elements)
Parameters:
searchStr - The string to be looked up in the array (null allowed) The index of the string in the array or -1 if not found |
| indexOfString | | protected int indexOfString(String[] strArray, String searchStr, boolean ignoreCase)(Code) | | |
| leftPad | | public String leftPad(String str, int len)(Code) | | Returns the given string filled (on the left) up to the specified length
with spaces.
Example: leftPad( "XX", 4 ) --> " XX"
Parameters:
str - The string that has to be filled up to the specified length
Parameters:
len - The length of the result string |
| leftPad | | public String leftPad(int value, int len)(Code) | | Returns the given integer as string filled (on the left) up to the
specified length with zeroes.
Example: leftPad( 12, 4 ) --> "0012"
Parameters:
value -
Parameters:
len - |
| leftPadCh | | public String leftPadCh(String str, int len, char ch)(Code) | | Returns the given string filled (on the left) up to the specified length
with the given character.
Example: leftPadCh( "12", 6, '0' ) --> "000012"
Parameters:
str -
Parameters:
len -
Parameters:
ch - |
| leftPadCh | | public String leftPadCh(int value, int len, char fillChar)(Code) | | Returns the given integer as string filled (on the left) up to the
specified length with the given fill character.
Example: leftPad( 24, 5, '' ) --> "24"
Parameters:
value -
Parameters:
len -
Parameters:
fillChar - |
| parts | | public String[] parts(String text, String delimiters)(Code) | | Returns an array of substrings of the given text.
The separators between the substrings are the given delimiters. Each
character in the delimiter string is treated as a separator.
All consecutive delimiters are treated as one delimiter, that is there
will be no empty strings in the result.
Parameters:
text - The string that should be splitted into substrings
Parameters:
delimiters - All characters that should be recognized as aseparator or substrings An array of substrings of the given text
See Also: StringUtil.allParts(String,String)
See Also: StringUtil.substrings(String,String)
See Also: StringUtil.allSubstrings(String,String) |
| parts | | protected String[] parts(String text, String delimiters, boolean all)(Code) | | Returns an array of substrings of the given text.
The separators between the substrings are the given delimiters. Each
character in the delimiter string is treated as a separator.
Parameters:
text - The string that should be splitted into substrings
Parameters:
delimiters - All characters that should be recognized as aseparator or substrings
Parameters:
all - If true, empty elements will be returned, otherwise thye areskipped An array of substrings of the given text |
| prefix | | public String prefix(String str, String separator)(Code) | | Returns the substring of the given string that comes before the first
occurance of the specified separator. If the string starts with a
separator, the result will be an empty string. If the string doesn't
contain the separator the method returns null.
Examples:
prefix( "A/B/C", "/" ) ; // returns "A"
prefix( "A/B/C", "," ) ; // returns null
Parameters:
str - The string of which the prefix is desired
Parameters:
separator - Separates the prefix from the rest of the string
See Also: StringUtil.suffix(String,String)
See Also: StringUtil.cutTail(String,String)
See Also: StringUtil.cutHead(String,String)
See Also: StringUtil.startingFrom(String,String)
See Also: StringUtil.upTo(String,String) |
| prefix | | protected String prefix(String str, String separator, boolean returnNull)(Code) | | Returns the substring of the given string that comes before the first
occurance of the specified separator. If the string starts with a
separator, the result will be an empty string. If the string doesn't
contain the separator the method returns null or the whole string,
depending on the returnNull flag.
Parameters:
str - The string of which the prefix is desired
Parameters:
separator - Separates the prefix from the rest of the string
Parameters:
returnNull - Specifies if null will be returned if no separator isfound |
| remove | | public String[] remove(String[] strings, String[] removeStrings)(Code) | | Removes all string of the second array from the first array. Returns a
new array of string that contains all remaining strings of the original
strings array.
Parameters:
strings - The array from which to remove the strings
Parameters:
removeStrings - The strings to be removed |
| remove | | public String[] remove(String[] strings, String removeString)(Code) | | Removes the given string from the specified string array. Returns a new
array of string that contains all remaining strings of the original
strings array.
Parameters:
strings - The array from which to remove the string
Parameters:
removeString - The string to be removed |
| removeFromStringArray | | protected String[] removeFromStringArray(String[] strings, String[] removeStrings)(Code) | | Removes the given strings from the array. If removeStrings is null it
means that all null values are removed from the first array.
Parameters:
strings -
Parameters:
removeStrings - |
| removeNull | | public String[] removeNull(String[] strings)(Code) | | Removes all null values from the given string array. Returns a new
string array that contains all none null values of the input array.
Parameters:
strings - The array to be cleared of null values |
| repeat | | public String repeat(char ch, int count)(Code) | | Returns a string with size of count and all characters initialized with
ch.
Parameters:
ch - the character to be repeated in the result string.
Parameters:
count - the number of times the given character should occur in theresult string. A string containing count characters ch. |
| replaceAll | | public String replaceAll(String sourceStr, String oldSubStr, String newSubStr)(Code) | | Returns the given string with all found oldSubStr replaced by newSubStr.
Example: StringUtil.current().replaceAll( "Seven of ten", "even", "ix"
) ;
results in: "Six of ten"
Parameters:
sourceStr - The string that should be checked for occurrences ofoldSubStr
Parameters:
oldSubStr - The string that is searched for in sourceStr
Parameters:
newSubStr - The new string that is placed everywhere the oldSubStrwas found The original string with all found substrings replaced by newstrings |
| reverse | | public String reverse(String str)(Code) | | Returns a string that contains all characters of the given string in
reverse order.
Parameters:
str - |
| rightPad | | public String rightPad(String str, int len)(Code) | | Returns the given string filled (on the right) up to the specified
length with spaces.
Example: rightPad( "88", 6 ) --> "88 "
Parameters:
str -
Parameters:
len - |
| rightPad | | public String rightPad(int value, int len)(Code) | | Returns the given integer as string filled (on the right) up to the
specified length with spaces.
Example: rightPad( "17", 5 ) --> "17 "
Parameters:
value -
Parameters:
len - |
| rightPadCh | | public String rightPadCh(String str, int len, char ch)(Code) | | Returns the given string filled (on the right) up to the specified
length with the given character.
Example: rightPadCh( "34", 5, 'X' ) --> "34XXX"
Parameters:
str -
Parameters:
len -
Parameters:
ch - |
| rightPadCh | | public String rightPadCh(int value, int len, char fillChar)(Code) | | Returns the given integer as string filled (on the right) up to the
specified length with the given character.
Example: rightPad( "32", 4, '#' ) --> "32##"
Parameters:
value -
Parameters:
len -
Parameters:
fillChar - |
| splitNameValue | | public String[] splitNameValue(String str, String separator)(Code) | | Returns a string array with two elements where the first is the
attribute name and the second is the attribute value. Splits the given
string at the first occurance of separator and returns the piece before
the separator in element 0 and the piece after the separator in the
returned array. If the separator is not found, the first element
contains the full string and the second an empty string.
Parameters:
str - The string that contains the name-value pair
Parameters:
separator - The separator between name and value |
| stackTrace | | public String stackTrace(Throwable throwable)(Code) | | Prints the stack trace of the specified throwable to a string and
returns it.
Parameters:
throwable - |
| substrings | | public String[] substrings(String text, String separator)(Code) | | Returns the given text split up into an array of strings, at the
occurrances of the separator string. In contrary to method parts() the
separator is a one or many character sequence delimiter. That is, only
the exact sequence of the characters in separator identifies the end
of a substring. Subsequent occurences of separator will be skipped.
Therefore no empty strings ("") will be in the result array.
Parameters:
text - The text to be split up
Parameters:
separator - The string that separates the substrings An array of substrings not containing any separator anymore
See Also: StringUtil.allSubstrings(String,String)
See Also: StringUtil.parts(String,String)
See Also: StringUtil.allParts(String,String) |
| substrings | | protected String[] substrings(String text, String separator, boolean all)(Code) | | Returns the given text split up into an array of strings, at the
occurrances of the separator string. In contrary to method parts() the
separator is a one or many character sequence delimiter. That is, only
the exact sequence of the characters in separator identifies the end
of a substring. Parameter all defines whether empty strings between
consecutive separators are added to the result or not.
Parameters:
text - The text to be split up
Parameters:
separator - The string that separates the substrings
Parameters:
all - If true, empty strings are added, otherwise skipped An array of substrings not containing any separator anymore
See Also: StringUtil.parts(String,String,boolean) |
| suffix | | public String suffix(String str, String separator)(Code) | | Returns the substring of the given string that comes after the first
occurance of the specified separator. If the string ends with a
separator, the result will be an empty string. If the string doesn't
contain the separator the method returns null.
Examples:
suffix( "A/B/C", "/" ) ; // returns "B/C"
suffix( "A/B/C", "," ) ; // returns null
Parameters:
str - The string of which the suffix is desired
Parameters:
separator - Separates the suffix from the rest of the string
See Also: StringUtil.prefix(String,String)
See Also: StringUtil.cutTail(String,String)
See Also: StringUtil.cutHead(String,String)
See Also: StringUtil.startingFrom(String,String)
See Also: StringUtil.upTo(String,String) |
| suffix | | protected String suffix(String str, String separator, boolean returnNull)(Code) | | Returns the substring of the given string that comes after the first
occurance of the specified separator. If the string ends with a
separator, the result will be an empty string. If the string doesn't
contain the separator the method returns null or the whole string,
depending on the returnNull flag.
Parameters:
str - The string of which the suffix is desired
Parameters:
separator - Separates the suffix from the rest of the string
Parameters:
returnNull - Specifies if null will be returned if no separator isfound |
| toMap | | public Map toMap(String str, String elementSeparator, String keyValueSeparator, Map map)(Code) | | Returns the given map with new entries from the specified String. If the
specified map is null a new empty java.util.Hashtable will be created.
The string is split up into elements separated by the elementSeparator
parameter. If this parameter is null the default separator "," is used.
After that each part is split up to a key-value pair separated by the
keyValueSeparator parameter. If this parameter is null the default "="
is used.
Then the key-value pairs are added to the map and the map is returned.
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
elementSeparator - The separator between the elements of the list
Parameters:
keyValueSeparator - The separator between the keys and values
Parameters:
map - The map to which the key-value pairs are added |
| toMap | | public Map toMap(String str, String elementSeparator, Map map)(Code) | | Returns the given map object with all key-value pairs of the specified
string added to it.
The separator between the keys and values is assumed to be "=".
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
elementSeparator - The separator between the elements of the list
Parameters:
map - The map to which the key-value pairs are added |
| toMap | | public Map toMap(String str, Map map)(Code) | | Adds all key-value pairs of the given string to the specified map.
The separator between the elements is assumed to be "," and "=" between
key and value.
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
map - The map to which the key-value pairs are added |
| toProperties | | public Properties toProperties(String str, Properties properties)(Code) | | Adds all key-value pairs of the given string to the specified
properties.
The separator between the elements is assumed to be "," and "=" between
key and value.
Be aware that all leading and trailing whitespaces of keys and values
will be removed!
Parameters:
str - The string that contains the list of key-value pairs
Parameters:
properties - The properties where the key-value pairs should beadded |
| trimSeparator | | protected String trimSeparator(String text, String separator)(Code) | | Cuts off all leading and trailing occurences of separator in text.
Parameters:
text -
Parameters:
separator - |
| upTo | | public String upTo(String str, String separator)(Code) | | Returns the substring of the given string that comes before the first
occurance of the specified separator. If the string starts with a
separator, the result will be an empty string. If the string doesn't
contain the separator the method returns the whole string unchanged.
Examples:
upTo( "A/B/C", "/" ) ; // returns "A"
upTo( "A/B/C", "," ) ; // returns "A/B/C"
upTo( "/A/B/C", "/" ) ; // returns ""
Parameters:
str - The string of which the prefix is desired
Parameters:
separator - Separates the prefix from the rest of the string
See Also: StringUtil.prefix(String,String)
See Also: StringUtil.cutTail(String,String)
See Also: StringUtil.cutHead(String,String)
See Also: StringUtil.startingFrom(String,String)
See Also: StringUtil.suffix(String,String) |
| words | | public String[] words(String text)(Code) | | Returns an array of substrings of the given text.
The delimiters between the substrings are the whitespace characters
SPACE, NEWLINE, CR and TAB.
Parameters:
text - The string that should be splitted into whitespace separatedwords An array of substrings of the given text
See Also: StringUtil.parts(String,String) |
|
|