nl.inl.util

Class StringUtil

java.lang.Object

nl.inl.util.StringUtil

public final class StringUtil
extends Object

A collection of String-related utility methods and regular expression patterns.

Field Summary

Fields

Modifier and Type	Field and Description
static char	CHAR_NON_BREAKING_SPACE nbsp character (decimal 160 = hex A0)

Method Summary

Modifier and Type	Method and Description
static String	camelCaseToDisplayable(String camelCaseString, boolean dashesToSpaces) Convert a string from a camel-case "identifier" style to a human-readable version, by putting spaces between words, uppercasing the first letter and lowercasing the rest.
static String	escapeRegexCharacters(String termStr) Escape regex special characters (Pattern.quote() also does this, but this method is needed if you use a different regex engine from Java's, such as with Lucene)
static String	normalizeWhitespace(String s) Replace adjacent whitespace characters with a single space
static String	ordinal(int docNumber) For a number n, return a string like "nth".
static String	stripAccents(String input) Removes diacritics (~= accents) from a string.
static String	trimWhitespaceAndPunctuation(String input) Remove any punctuation and whitespace at the start and end of input.
static String	wildcardToRegex(String wildcard) Convert wildcard string to regex string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CHAR_NON_BREAKING_SPACE

public static final char CHAR_NON_BREAKING_SPACE

nbsp character (decimal 160 = hex A0)

See Also:

Constant Field Values

Method Detail

escapeRegexCharacters

public static String escapeRegexCharacters(String termStr)

Escape regex special characters (Pattern.quote() also does this, but this method is needed if you use a different regex engine from Java's, such as with Lucene)

Parameters:

termStr - the string to escape characters in

Returns:

the escaped string

normalizeWhitespace

public static String normalizeWhitespace(String s)

Replace adjacent whitespace characters with a single space

Parameters:

s - source string

Returns:

the result

stripAccents

public static String stripAccents(String input)

Removes diacritics (~= accents) from a string. The case will not be altered.

For instance, 'à' will be replaced by 'a'.

Note that ligatures will be left as is.

 StringUtils.stripAccents(null)                = null
 StringUtils.stripAccents("")                  = ""
 StringUtils.stripAccents("control")           = "control"
 StringUtils.stripAccents("éclair")     = "eclair"
 

NOTE: this method was copied from Apache StringUtils. The only change is precompiling the regular expression for efficiency.

Parameters:

input - String to be stripped

Returns:

input text with diacritics removed

Since:

3.0

trimWhitespaceAndPunctuation

public static String trimWhitespaceAndPunctuation(String input)

Remove any punctuation and whitespace at the start and end of input.

Parameters:

input - the input string

Returns:

the string without punctuation or whitespace at the edges.

camelCaseToDisplayable

public static String camelCaseToDisplayable(String camelCaseString,
                                            boolean dashesToSpaces)

Convert a string from a camel-case "identifier" style to a human-readable version, by putting spaces between words, uppercasing the first letter and lowercasing the rest. E.g. myCamelCaseString becomes "My camel case string".

Parameters:

camelCaseString - a string in camel case, i.e. multiple capitalized words glued together.

dashesToSpaces - if true, also converts dashes and underscores to spaces

Returns:

a human-readable version of the input string

ordinal

public static String ordinal(int docNumber)

For a number n, return a string like "nth". So 1 returns "1st", 2 returns "2nd", and so on.

Parameters:

docNumber - number

Returns:

ordinal for that number

wildcardToRegex

public static String wildcardToRegex(String wildcard)

Convert wildcard string to regex string. Adapted from: http://stackoverflow.com/a/28758377

Parameters:

wildcard - wildcard pattern

Returns:

equivalent regex pattern