de.larssh.utils.text

Class Characters

java.lang.Object

de.larssh.utils.text.Characters

public final class Characters
extends Object

This class contains helper methods for Character.

Method Summary

Modifier and Type	Method and Description
static int	compareIgnoreCase(char first, char second) Compares two char values lexicographically, ignoring case differences.
static int	compareIgnoreCaseAscii(char first, char second) Compares two char values, ignoring case differences in the ASCII range.
static boolean	equalsIgnoreCase(char first, char second) Compares the characters, ignoring case considerations.
static boolean	equalsIgnoreCaseAscii(char first, char second) Compares the characters, ignoring case considerations in the ASCII range.
static boolean	isAsciiDigit(char character) Determines if the specified character is an ASCII digit.
static boolean	isAsciiLetter(char character) Determines if the specified character is an ASCII letter.
static boolean	isAsciiWhitespace(char character) Determines if the specified character is an ASCII white space.
static char	toLowerCaseAscii(char character) Converts the character argument to lowercase when inside the ASCII range.
static char	toUpperCaseAscii(char character) Converts the character argument to uppercase when inside the ASCII range.

Methods inherited from class java.lang.Object

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

Method Detail

compareIgnoreCase

public static int compareIgnoreCase(char first,
                                    char second)

Compares two char values lexicographically, ignoring case differences. This method eliminates case differences by calling Character.toLowerCase(Character.toUpperCase(character)).

Note that this method does not take locale into account, and will result in an unsatisfactory ordering for certain locales.

Parameters:

first - the first char to compare

second - the second char to compare

Returns:

a positive integer, zero, or a negative integer as first char is greater than, equal to, or less than second char, ignoring case considerations.

compareIgnoreCaseAscii

public static int compareIgnoreCaseAscii(char first,
                                         char second)

Compares two char values, ignoring case differences in the ASCII range. This method eliminates case differences by calling Characters.toLowerCaseAscii(character).

Note that this method does not ignore the case for characters outside of the ASCII range.

Parameters:

first - the first char to compare

second - the second char to compare

Returns:

a positive integer, zero, or a negative integer as first char is greater than, equal to, or less than second char, ignoring case considerations in the ASCII range.

equalsIgnoreCase

public static boolean equalsIgnoreCase(char first,
                                       char second)

Compares the characters, ignoring case considerations.

Parameters:

first - the first char to compare

second - the second char to compare

Returns:

true if the objects are the same, ignoring case considerations; false otherwise.

equalsIgnoreCaseAscii

public static boolean equalsIgnoreCaseAscii(char first,
                                            char second)

Compares the characters, ignoring case considerations in the ASCII range.

Parameters:

first - the first char to compare

second - the second char to compare

Returns:

true if the objects are the same, ignoring case considerations; false otherwise.

isAsciiDigit

public static boolean isAsciiDigit(char character)

Determines if the specified character is an ASCII digit.

This method provides higher performance than Character.isDigit(char) while not checking Unicode character ranges.

Parameters:

character - the character to be tested

Returns:

true if the character is an ASCII digit; false otherwise.

isAsciiLetter

public static boolean isAsciiLetter(char character)

Determines if the specified character is an ASCII letter.

This method provides higher performance than Character.isLetter(char) while not checking Unicode character ranges. It returns true for characters A to Z and a to z.

Parameters:

character - the character to be tested

Returns:

true if the character is an ASCII letter; false otherwise.

isAsciiWhitespace

public static boolean isAsciiWhitespace(char character)

Determines if the specified character is an ASCII white space.

This method provides higher performance than Character.isWhitespace(char) while not checking Unicode character ranges. It is equivalent to white space checking of String.trim().

Parameters:

character - the character to be tested

Returns:

true if the character is an ASCII white space; false otherwise.

toLowerCaseAscii

public static char toLowerCaseAscii(char character)

Converts the character argument to lowercase when inside the ASCII range.

Parameters:

character - the character to be converted.

Returns:

the lowercase equivalent of the character, if any; otherwise, the character itself.

See Also:

Character.isLowerCase(char), String.toLowerCase()

toUpperCaseAscii

public static char toUpperCaseAscii(char character)

Converts the character argument to uppercase when inside the ASCII range.

Parameters:

character - the character to be converted.

Returns:

the uppercase equivalent of the character, if any; otherwise, the character itself.

See Also:

Character.isUpperCase(char), String.toUpperCase()