org.apache.commons.lang
Class CharSetUtils
public class CharSetUtils
Operations on
CharSets.
This class handles
null input gracefully.
An exception will not be thrown for a
null input.
Each method documents its behaviour in more detail.
$Id: CharSetUtils.java 161243 2005-04-14 04:30:28Z ggregory $CharSetUtils()- CharSetUtils instances should NOT be constructed in standard programming.
|
static int | count(String str, String set)- Takes an argument in set-syntax, see evaluateSet,
and returns the number of characters present in the specified string.
|
static int | count(String str, String[] set)- Takes an argument in set-syntax, see evaluateSet,
and returns the number of characters present in the specified string.
|
static String | delete(String str, String set)- Takes an argument in set-syntax, see evaluateSet,
and deletes any of characters present in the specified string.
|
static String | delete(String str, String[] set)- Takes an argument in set-syntax, see evaluateSet,
and deletes any of characters present in the specified string.
|
static CharSet | evaluateSet(String[] set)- Use
CharSet.getInstance(String).
|
static String | keep(String str, String set)- Takes an argument in set-syntax, see evaluateSet,
and keeps any of characters present in the specified string.
|
static String | keep(String str, String[] set)- Takes an argument in set-syntax, see evaluateSet,
and keeps any of characters present in the specified string.
|
static String | squeeze(String str, String set)- Squeezes any repetitions of a character that is mentioned in the
supplied set.
|
static String | squeeze(String str, String[] set)- Squeezes any repetitions of a character that is mentioned in the
supplied set.
|
static String | translate(String str, String searchChars, String replaceChars)- Use
StringUtils.replaceChars(String,String,String).
|
CharSetUtils
public CharSetUtils()
CharSetUtils instances should NOT be constructed in standard programming.
Instead, the class should be used as
CharSetUtils.evaluateSet(null);.
This constructor is public to permit tools that require a JavaBean instance
to operate.
count
public static int count(String str,
String set) Takes an argument in set-syntax, see evaluateSet,
and returns the number of characters present in the specified string.
CharSetUtils.count(null, *) = 0
CharSetUtils.count("", *) = 0
CharSetUtils.count(*, null) = 0
CharSetUtils.count(*, "") = 0
CharSetUtils.count("hello", "k-p") = 3
CharSetUtils.count("hello", "a-e") = 1
str - String to count characters in, may be nullset - String set of characters to count, may be null
- character count, zero if null string input
count
public static int count(String str,
String[] set) Takes an argument in set-syntax, see evaluateSet,
and returns the number of characters present in the specified string.
An example would be:
- count("hello", {"c-f", "o"}) returns 2.
str - String to count characters in, may be nullset - String[] set of characters to count, may be null
- character count, zero if null string input
delete
public static String delete(String str,
String set) Takes an argument in set-syntax, see evaluateSet,
and deletes any of characters present in the specified string.
CharSetUtils.delete(null, *) = null
CharSetUtils.delete("", *) = ""
CharSetUtils.delete(*, null) = *
CharSetUtils.delete(*, "") = *
CharSetUtils.delete("hello", "hl") = "eo"
CharSetUtils.delete("hello", "le") = "ho"
str - String to delete characters from, may be nullset - String set of characters to delete, may be null
- modified String,
null if null string input
delete
public static String delete(String str,
String[] set) Takes an argument in set-syntax, see evaluateSet,
and deletes any of characters present in the specified string.
An example would be:
- delete("hello", {"c-f", "o"}) returns
"hll"
str - String to delete characters from, may be nullset - String[] set of characters to delete, may be null
- modified String,
null if null string input
evaluateSet
public static CharSet evaluateSet(String[] set)
Use CharSet.getInstance(String).
Method will be removed in Commons Lang 3.0.
Creates a
CharSet instance which allows a certain amount of
set logic to be performed.
The syntax is:
- "aeio" which implies 'a','e',..
- "^e" implies not e.
- "ej-m" implies e,j->m. e,j,k,l,m.
CharSetUtils.evaluateSet(null) = null
CharSetUtils.evaluateSet([]) = CharSet matching nothing
CharSetUtils.evaluateSet(["a-e"]) = CharSet matching a,b,c,d,e
set - the set, may be null
- a CharSet instance,
null if null input
keep
public static String keep(String str,
String set) Takes an argument in set-syntax, see evaluateSet,
and keeps any of characters present in the specified string.
CharSetUtils.keep(null, *) = null
CharSetUtils.keep("", *) = ""
CharSetUtils.keep(*, null) = ""
CharSetUtils.keep(*, "") = ""
CharSetUtils.keep("hello", "hl") = "hll"
CharSetUtils.keep("hello", "le") = "ell"
str - String to keep characters from, may be nullset - String set of characters to keep, may be null
- modified String,
null if null string input
keep
public static String keep(String str,
String[] set) Takes an argument in set-syntax, see evaluateSet,
and keeps any of characters present in the specified string.
An example would be:
- keep("hello", {"c-f", "o"})
returns "eo"
str - String to keep characters from, may be nullset - String[] set of characters to keep, may be null
- modified String,
null if null string input
squeeze
public static String squeeze(String str,
String set) Squeezes any repetitions of a character that is mentioned in the
supplied set.
CharSetUtils.squeeze(null, *) = null
CharSetUtils.squeeze("", *) = ""
CharSetUtils.squeeze(*, null) = *
CharSetUtils.squeeze(*, "") = *
CharSetUtils.squeeze("hello", "k-p") = "helo"
CharSetUtils.squeeze("hello", "a-e") = "hello"
str - the string to squeeze, may be nullset - the character set to use for manipulation, may be null
- modified String,
null if null string input
squeeze
public static String squeeze(String str,
String[] set) Squeezes any repetitions of a character that is mentioned in the
supplied set.
An example is:
- squeeze("hello", {"el"}) => "helo"
str - the string to squeeze, may be nullset - the character set to use for manipulation, may be null
- modified String,
null if null string input
translate
public static String translate(String str,
String searchChars,
String replaceChars)Use StringUtils.replaceChars(String,String,String).
Method will be removed in Commons Lang 3.0.
NOTE: StringUtils#replaceChars behaves differently when 'searchChars' is longer
than 'replaceChars'. CharSetUtils#translate will use the last char of the replacement
string whereas StringUtils#replaceChars will delete
Translate characters in a String.
This is a multi character search and replace routine.
An example is:
- translate("hello", "ho", "jy")
=> jelly
If the length of characters to search for is greater than the
length of characters to replace, then the last character is
used.
CharSetUtils.translate(null, *, *) = null
CharSetUtils.translate("", *, *) = ""
str - String to replace characters in, may be nullsearchChars - a set of characters to search for, must not be nullreplaceChars - a set of characters to replace, must not be null or empty ("")
- translated String,
null if null string input
Copyright © 2001-2005 - Apache Software Foundation