de.ipcon.tools

Class CharacterTools

java.lang.Object

de.ipcon.tools.CharacterTools

public final class CharacterTools
extends java.lang.Object

Utility class providing high-performance, strict ASCII character evaluations.

Note: This class deliberately avoids using the built-in Character methods (like isWhitespace or isJavaIdentifierPart). The standard Java methods evaluate the entire Unicode spectrum, which introduces risks in a parser pipeline:

• Security: Prevents query obfuscation via invisible characters or homoglyphs.
• Performance: Bypasses native Unicode category lookups in favor of primitive boolean boundary checks.

Method Summary

Modifier and Type	Method and Description
static boolean	isAsciiDigit(char c) Evaluates if a character is a standard ASCII digit (0-9).
static boolean	isAsciiIdentifierPart(char c) Evaluates if a character is a valid, strict ASCII continuing character for an OQL identifier.
static boolean	isAsciiIdentifierStart(char c) Evaluates if a character is a valid, strict ASCII starting character for an OQL identifier.
static boolean	isAsciiWhitespace(char c) Evaluates if a character is standard ASCII whitespace.
static byte	toByte(char c) Fast primitive coercion from char to byte.
static char	toChar(byte b) Fast primitive coercion from byte to char.
static char	toChar(int i) Fast primitive coercion from integer to char.
static int	toInt(char c) Fast primitive coercion from char to integer.

Methods inherited from class java.lang.Object

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

Method Detail

isAsciiDigit

public static boolean isAsciiDigit(char c)

Evaluates if a character is a standard ASCII digit (0-9).

Parameters:

c - the character to evaluate

Returns:

true if the character is between '0' and '9'

isAsciiWhitespace

public static boolean isAsciiWhitespace(char c)

Evaluates if a character is standard ASCII whitespace.

Parameters:

c - the character to evaluate

Returns:

true if the character is a space, tab, newline, carriage return, or form feed

isAsciiIdentifierStart

public static boolean isAsciiIdentifierStart(char c)

Evaluates if a character is a valid, strict ASCII starting character for an OQL identifier.

Parameters:

c - the character to evaluate

Returns:

true if the character is an unaccented Latin letter (A-Z, a-z) or an underscore

isAsciiIdentifierPart

public static boolean isAsciiIdentifierPart(char c)

Evaluates if a character is a valid, strict ASCII continuing character for an OQL identifier.

Parameters:

c - the character to evaluate

Returns:

true if the character is an unaccented Latin letter, a digit, or an underscore

toChar

public static char toChar(byte b)

Fast primitive coercion from byte to char.

Parameters:

b - the byte to coerce

Returns:

the corresponding 16-bit character

toChar

public static char toChar(int i)

Fast primitive coercion from integer to char.

Parameters:

i - the integer to coerce

Returns:

the corresponding 16-bit character

toByte

public static byte toByte(char c)

Fast primitive coercion from char to byte.

Note: This causes data loss for characters outside the 8-bit range!

Parameters:

c - the character to coerce

Returns:

the truncated 8-bit byte

toInt

public static int toInt(char c)

Fast primitive coercion from char to integer.

Parameters:

c - the character to coerce

Returns:

the 32-bit integer representation of the character