|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.generationjava.lang.StringW
public final class StringW
A set of String library static methods. While extending String or StringBuffer would have been the nicest solution, that is not possible, so a simple set of static methods seems the most workable. Method ideas have so far been taken from the PHP4, Ruby and .NET languages.
Field Summary | |
---|---|
static java.lang.String |
LINE_SEPARATOR
|
Constructor Summary | |
---|---|
StringW()
|
Method Summary | |
---|---|
static java.lang.String |
capitalise(java.lang.String str)
Capitalise a string. |
static java.lang.String |
capitaliseAllWords(java.lang.String str)
Capitalise all the words in a string. |
static java.lang.String |
center(java.lang.String str,
int n)
Center a string in a larger string of size n. |
static java.lang.String |
center(java.lang.String str,
int n,
java.lang.String delim)
Center a string in a larger string of size n. |
static java.lang.String |
center(java.lang.String str,
java.lang.String n,
java.lang.String delim)
|
static java.lang.String |
chomp(java.lang.String str)
Remove the last newline, and everything after it from a String. |
static java.lang.String |
chomp(java.lang.String str,
java.lang.String sep)
Remove the last value of a supplied String, and everything after it from a String. |
static java.lang.String |
chompLast(java.lang.String str)
Remove a newline if and only if it is at the end of the supplied string. |
static java.lang.String |
chompLast(java.lang.String str,
java.lang.String sep)
|
static java.lang.String |
chop(java.lang.String str)
Remove the last character from a String. |
static java.lang.String |
chopNewline(java.lang.String str)
Remove \n from end of a String if it's there. |
static int |
count(java.lang.String str,
java.lang.String set)
|
static int |
count(java.lang.String str,
java.lang.String[] set)
Takes an argument in set-syntax, see evaluateSet, and returns the number of characters present in the specified string. |
static int |
countMatches(java.lang.String str,
java.lang.String sub)
How mmany times is the substring in the larger string. |
static java.lang.String |
defaultString(java.lang.String str)
Return either the passed in String, or if it is null, then an empty String. |
static java.lang.String |
defaultString(java.lang.String str,
java.lang.String def)
Return either the passed in String, or if it is null, then a passed in default String. |
static java.lang.String |
delete(java.lang.String str,
java.lang.String set)
|
static java.lang.String |
delete(java.lang.String str,
java.lang.String[] set)
Takes an argument in set-syntax, see evaluateSet, and deletes any of characters present in the specified string. |
static java.lang.String |
escape(java.lang.String str)
Escapes any values it finds into their String form. |
static CharSet |
evaluateSet(java.lang.String[] set)
Creates a CharSet object which allows a certain amount of set logic to be performed upon the following syntax: "aeio" which implies 'a','e',.. |
static java.lang.String[] |
explode(java.lang.String str)
Turn a space-separated string into an array of Strings. |
static java.lang.String[] |
explode(java.lang.String str,
java.lang.String sep)
Turn a separated string into an array of Strings. |
static java.lang.String[] |
explode(java.lang.String str,
java.lang.String sep,
int n)
Turn a separated string into an array of Strings. |
static java.lang.String[] |
explode(java.lang.String str,
java.lang.String sep,
java.lang.String n)
|
static java.lang.String |
getChomp(java.lang.String str,
java.lang.String sep)
Remove everything and return the last value of a supplied String, and everything after it from a String. |
static int |
getLevenshteinDistance(java.lang.String s,
java.lang.String t)
Find the Levenshtein distance between two strings. |
static java.lang.String |
getNestedString(java.lang.String str,
java.lang.String tag)
Get the String that is nested in between two instances of the same String. |
static java.lang.String |
getNestedString(java.lang.String str,
java.lang.String open,
java.lang.String close)
Get the string that is nested in between two strings. |
static java.lang.String |
getPrechomp(java.lang.String str,
java.lang.String sep)
Remove and return everything before the first value of a supplied String from another String. |
static java.lang.String |
implode(java.util.Enumeration enume,
java.lang.String sep)
|
static java.lang.String |
implode(java.util.Iterator iterator,
java.lang.String sep)
Merge an Iterator of Objects into a list of delimited Strings. |
static java.lang.String |
implode(java.lang.Object[] objs,
java.lang.String sep)
Merge an array of Objects into a list of delimited Strings. |
static java.lang.String |
implode(java.lang.Object[] objs,
java.lang.String sep,
java.lang.String pre,
java.lang.String post)
|
static int |
indexOfAny(java.lang.String str,
java.lang.String[] strs)
Find the earlier index of any of a set of potential substrings. |
static java.lang.String |
interpolate(java.lang.String text,
java.util.Map map)
Interpolate variables into a String. |
static boolean |
isAlphanumeric(java.lang.String str)
Does a String contain only unicode letters or digits. |
static boolean |
isLine(java.lang.String str)
Is a String a line, containing only letters, digits or whitespace, and ending with an optional newline. |
static boolean |
isMetaphoneEqual(java.lang.String str1,
java.lang.String str2)
Are the metaphones of two strings the same. |
static boolean |
isNumeric(java.lang.String str)
Does a String contain only unicode digits. |
static boolean |
isWord(java.lang.String str)
Is a String a word. |
static int |
lastIndexOfAny(java.lang.String str,
java.lang.String[] strs)
Find the latest index of any of a set of potential substrings. |
static java.lang.String |
leftPad(java.lang.String str,
int n)
Left pad a String with spaces. |
static java.lang.String |
leftPad(java.lang.String str,
int n,
java.lang.String delim)
Left pad a String with a specified string. |
static java.lang.String |
leftPad(java.lang.String str,
java.lang.String n,
java.lang.String delim)
|
static java.lang.String |
lowerCase(java.lang.String str)
|
static java.lang.String |
metaphone(java.lang.String str)
Find the metaphone value of a String. |
static java.lang.String |
overlayString(java.lang.String text,
java.lang.String overlay,
int start,
int end)
Overlay a part of a string with another string. |
static java.lang.String |
overlayString(java.lang.String text,
java.lang.String overlay,
java.lang.String start,
java.lang.String end)
|
static java.lang.String |
prechomp(java.lang.String str,
java.lang.String sep)
Remove the first value of a supplied String, and everything before it from a String. |
static java.lang.String |
quoteRegularExpression(java.lang.String str)
Quote a string so that it may be used in a regular expression without any parts of the string being considered as a part of the regular expression's control characters. |
static java.lang.String |
random(int count)
|
static java.lang.String |
random(int count,
boolean letters,
boolean numbers)
|
static java.lang.String |
random(int count,
char[] set)
|
static java.lang.String |
random(int count,
int start,
int end,
boolean letters,
boolean numbers)
|
static java.lang.String |
random(int count,
int start,
int end,
boolean letters,
boolean numbers,
char[] set)
Create a random string based on a variety of options. |
static java.lang.String |
random(int count,
java.lang.String set)
|
static java.lang.String |
randomAlphabetic(int count)
|
static java.lang.String |
randomAlphanumeric(int count)
|
static java.lang.String |
randomAscii(int count)
|
static java.lang.String |
randomNumeric(int count)
|
static java.lang.String |
repeat(java.lang.String str,
int n)
Repeat a string n times to form a new string. |
static java.lang.String |
repeat(java.lang.String str,
java.lang.String n)
|
static java.lang.String |
replaceString(java.lang.String text,
java.lang.String repl,
java.lang.String with)
Replace a string with another string inside a larger string, for all of the search string. |
static java.lang.String |
replaceString(java.lang.String text,
java.lang.String repl,
java.lang.String with,
int max)
Replace a string with another string inside a larger string, for the first n values of the search string. |
static java.lang.String |
replaceString(java.lang.String text,
java.lang.String repl,
java.lang.String with,
java.lang.String n)
|
static java.lang.String |
replaceStringOnce(java.lang.String text,
java.lang.String repl,
java.lang.String with)
Replace a string with another string inside a larger string, once. |
static java.lang.String |
reverse(java.lang.String str)
Reverse a String. |
static java.lang.String |
reverseDelimitedString(java.lang.String text,
java.lang.String delimiter)
|
static java.lang.String |
reverseDottedName(java.lang.String text)
|
static java.lang.String |
rightPad(java.lang.String str,
int n)
Right pad a String with spaces. |
static java.lang.String |
rightPad(java.lang.String str,
int n,
java.lang.String delim)
Right pad a String with a specified string. |
static java.lang.String |
rightPad(java.lang.String str,
java.lang.String n,
java.lang.String delim)
|
static java.lang.String |
soundex(java.lang.String str)
Get the SoundEx value of a string. |
static java.lang.String |
squeeze(java.lang.String str,
java.lang.String set)
|
static java.lang.String |
squeeze(java.lang.String str,
java.lang.String[] set)
Squeezes any repititions of a character that is mentioned in the supplied set. |
static java.lang.String |
strip(java.lang.String str)
Remove whitespace from the front and back of a String. |
static java.lang.String |
strip(java.lang.String str,
java.lang.String delim)
Remove a specified String from the front and back of a String. |
static java.lang.String |
stripEnd(java.lang.String str,
java.lang.String ch)
Strip any of a supplied substring from the end of a String.. |
static java.lang.String |
stripStart(java.lang.String str,
java.lang.String ch)
Strip any of a supplied substring from the start of a String.. |
static java.lang.String |
substring(java.lang.String str,
int start)
|
static java.lang.String |
substring(java.lang.String str,
int start,
int end)
|
static java.lang.String |
substring(java.lang.String str,
java.lang.String start)
|
static java.lang.String |
substring(java.lang.String str,
java.lang.String start,
java.lang.String end)
|
static java.lang.String |
swapCase(java.lang.String str)
Swaps the case of String. |
static java.lang.String |
translate(java.lang.String target,
java.lang.String repl,
java.lang.String with)
Translate characters in a String. |
static java.lang.String |
trim(java.lang.String str)
|
static java.lang.String |
uncapitalise(java.lang.String str)
Uncapitalise a string. |
static java.lang.String |
upperCase(java.lang.String str)
|
static java.lang.String |
wordWrap(java.lang.String str)
Create a word-wrapped version of a String. |
static java.lang.String |
wordWrap(java.lang.String str,
int width)
Create a word-wrapped version of a String. |
static java.lang.String |
wordWrap(java.lang.String str,
int width,
java.lang.String delim,
java.lang.String split)
Word-wrap a string. |
static java.lang.String |
wordWrap(java.lang.String str,
java.lang.String width,
java.lang.String delim,
java.lang.String split)
|
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static java.lang.String LINE_SEPARATOR
Constructor Detail |
---|
public StringW()
Method Detail |
---|
public static java.lang.String implode(java.lang.Object[] objs, java.lang.String sep, java.lang.String pre, java.lang.String post)
public static java.lang.String implode(java.lang.Object[] objs, java.lang.String sep)
objs
- Object[] to put into String list formsep
- String delimiter
public static java.lang.String implode(java.util.Iterator iterator, java.lang.String sep)
objs
- Object[] to put into String list formsep
- String delimiter
public static java.lang.String implode(java.util.Enumeration enume, java.lang.String sep)
public static java.lang.String[] explode(java.lang.String str)
str
- String to separate
public static java.lang.String[] explode(java.lang.String str, java.lang.String sep)
str
- String to separatesep
- String separator
public static java.lang.String[] explode(java.lang.String str, java.lang.String sep, java.lang.String n)
public static java.lang.String[] explode(java.lang.String str, java.lang.String sep, int n)
str
- String to separatesep
- String separatorn
- int max length of the array
public static java.lang.String uncapitalise(java.lang.String str)
str
- String to uncapitalise
public static java.lang.String capitalise(java.lang.String str)
str
- String to capitalise
public static java.lang.String replaceStringOnce(java.lang.String text, java.lang.String repl, java.lang.String with)
text
- String to do search and replace inrepl
- String to search forwith
- String to replace with
public static java.lang.String replaceString(java.lang.String text, java.lang.String repl, java.lang.String with)
text
- String to do search and replace inrepl
- String to search forwith
- String to replace with
public static java.lang.String replaceString(java.lang.String text, java.lang.String repl, java.lang.String with, java.lang.String n)
public static java.lang.String replaceString(java.lang.String text, java.lang.String repl, java.lang.String with, int max)
text
- String to do search and replace inrepl
- String to search forwith
- String to replace withn
- int values to replace
public static java.lang.String overlayString(java.lang.String text, java.lang.String overlay, java.lang.String start, java.lang.String end)
public static java.lang.String overlayString(java.lang.String text, java.lang.String overlay, int start, int end)
text
- String to do overlaying inoverlay
- String to overlaystart
- int to start overlaying atend
- int to stop overlaying before
public static java.lang.String repeat(java.lang.String str, java.lang.String n)
public static java.lang.String repeat(java.lang.String str, int n)
str
- String to repeatn
- int number of times to repeat
public static java.lang.String center(java.lang.String str, int n)
str
- String to centern
- int size of new String
public static java.lang.String center(java.lang.String str, java.lang.String n, java.lang.String delim)
public static java.lang.String center(java.lang.String str, int n, java.lang.String delim)
str
- String to centern
- int size of new Stringdelim
- String to buffer the new String with
public static java.lang.String chomp(java.lang.String str)
str
- String to chomp the newline from
public static java.lang.String chomp(java.lang.String str, java.lang.String sep)
str
- String to chomp fromsep
- String to chomp
public static java.lang.String chompLast(java.lang.String str)
public static java.lang.String chompLast(java.lang.String str, java.lang.String sep)
public static java.lang.String getChomp(java.lang.String str, java.lang.String sep)
str
- String to chomp fromsep
- String to chomp
public static java.lang.String prechomp(java.lang.String str, java.lang.String sep)
str
- String to chomp fromsep
- String to chomp
public static java.lang.String getPrechomp(java.lang.String str, java.lang.String sep)
str
- String to chomp fromsep
- String to chomp
public static java.lang.String chop(java.lang.String str)
str
- String to chop last character from
public static java.lang.String chopNewline(java.lang.String str)
str
- String to chop a newline fromString
- without newline on endpublic static CharSet evaluateSet(java.lang.String[] set)
public static int count(java.lang.String str, java.lang.String set)
public static int count(java.lang.String str, java.lang.String[] set)
str
- String target to count characters instr
- String[] set of characters to countpublic static java.lang.String delete(java.lang.String str, java.lang.String set)
public static java.lang.String delete(java.lang.String str, java.lang.String[] set)
str
- String target to delete characters fromstr
- String[] set of characters to deletepublic static java.lang.String squeeze(java.lang.String str, java.lang.String set)
public static java.lang.String squeeze(java.lang.String str, java.lang.String[] set)
public static java.lang.String translate(java.lang.String target, java.lang.String repl, java.lang.String with)
target
- String to replace characters inrepl
- String to find that will be replacedwith
- String to put into the target Stringpublic static java.lang.String escape(java.lang.String str)
str
- String to escape values in
public static java.lang.String rightPad(java.lang.String str, int n)
public static java.lang.String rightPad(java.lang.String str, java.lang.String n, java.lang.String delim)
public static java.lang.String rightPad(java.lang.String str, int n, java.lang.String delim)
str
- String to pad outn
- int size to pad todelim
- String to pad withpublic static java.lang.String leftPad(java.lang.String str, int n)
public static java.lang.String leftPad(java.lang.String str, java.lang.String n, java.lang.String delim)
public static java.lang.String leftPad(java.lang.String str, int n, java.lang.String delim)
str
- String to pad outn
- int size to pad todelim
- String to pad withpublic static java.lang.String reverse(java.lang.String str)
public static java.lang.String strip(java.lang.String str)
public static java.lang.String strip(java.lang.String str, java.lang.String delim)
public static java.lang.String swapCase(java.lang.String str)
public static int indexOfAny(java.lang.String str, java.lang.String[] strs)
public static int lastIndexOfAny(java.lang.String str, java.lang.String[] strs)
public static java.lang.String stripEnd(java.lang.String str, java.lang.String ch)
public static java.lang.String stripStart(java.lang.String str, java.lang.String ch)
public static int getLevenshteinDistance(java.lang.String s, java.lang.String t)
public static java.lang.String soundex(java.lang.String str)
public static java.lang.String metaphone(java.lang.String str)
public static boolean isMetaphoneEqual(java.lang.String str1, java.lang.String str2)
public static java.lang.String quoteRegularExpression(java.lang.String str)
public static java.lang.String capitaliseAllWords(java.lang.String str)
public static java.lang.String wordWrap(java.lang.String str)
public static java.lang.String wordWrap(java.lang.String str, int width)
public static java.lang.String wordWrap(java.lang.String str, java.lang.String width, java.lang.String delim, java.lang.String split)
public static java.lang.String wordWrap(java.lang.String str, int width, java.lang.String delim, java.lang.String split)
str
- String to word-wrapwidth
- int to wrap atdelim
- String to use to separate linessplit
- String to use to split a word greater than width long
public static java.lang.String getNestedString(java.lang.String str, java.lang.String tag)
str
- String containing nested-stringtag
- String before and after nested-string
public static java.lang.String getNestedString(java.lang.String str, java.lang.String open, java.lang.String close)
str
- String containing nested-stringopen
- String before nested-stringclose
- String after nested-string
public static int countMatches(java.lang.String str, java.lang.String sub)
public static boolean isWord(java.lang.String str)
public static boolean isAlphanumeric(java.lang.String str)
public static boolean isNumeric(java.lang.String str)
public static boolean isLine(java.lang.String str)
public static java.lang.String defaultString(java.lang.String str)
public static java.lang.String defaultString(java.lang.String str, java.lang.String def)
public static java.lang.String upperCase(java.lang.String str)
public static java.lang.String lowerCase(java.lang.String str)
public static java.lang.String trim(java.lang.String str)
public static java.lang.String substring(java.lang.String str, java.lang.String start)
public static java.lang.String substring(java.lang.String str, int start)
public static java.lang.String substring(java.lang.String str, java.lang.String start, java.lang.String end)
public static java.lang.String substring(java.lang.String str, int start, int end)
public static java.lang.String random(int count)
public static java.lang.String randomAscii(int count)
public static java.lang.String randomAlphabetic(int count)
public static java.lang.String randomAlphanumeric(int count)
public static java.lang.String randomNumeric(int count)
public static java.lang.String random(int count, boolean letters, boolean numbers)
public static java.lang.String random(int count, int start, int end, boolean letters, boolean numbers)
public static java.lang.String random(int count, int start, int end, boolean letters, boolean numbers, char[] set)
count
- int length of random string to createstart
- int position in set of chars to start atend
- int position in set of chars to end beforeletters
- boolean only allow letters?numbers
- boolean only allow numbers?set
- char[] set of chars to choose randoms from.
If null, then it will use the set of all chars.public static java.lang.String random(int count, java.lang.String set)
public static java.lang.String random(int count, char[] set)
public static java.lang.String reverseDottedName(java.lang.String text)
public static java.lang.String reverseDelimitedString(java.lang.String text, java.lang.String delimiter)
public static java.lang.String interpolate(java.lang.String text, java.util.Map map)
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |