com.phloc.commons.i18n

Class CodepointUtils

java.lang.Object

com.phloc.commons.i18n.CodepointUtils

@Immutable
public final class CodepointUtils
extends Object

General utilities for dealing with Unicode characters

Author:

Apache Abdera

Field Summary

Fields

Modifier and Type	Field and Description
static char	LRE
static char	LRM
static char	LRO
static char	PDF
static char	RLE
static char	RLM
static char	RLO

Method Summary

Methods

Modifier and Type	Method and Description
static Codepoint	codepointAt(CharSequence s, int i) Return the codepoint at the given location, automatically dealing with surrogate pairs
static char[]	getAsCharArray(int c) Return the char[] representation of the codepoint, automatically dealing with surrogate pairs
static String	getAsString(int c) Return the String representation of the codepoint, automatically dealing with surrogate pairs
static char	getHighSurrogate(int c) Get the high surrogate for a particular unicode codepoint
static int	getIndex(int[] aCodepointSet, int nValue)
static char	getLowSurrogate(int c) Get the low surrogate for a particular unicode codepoint
static boolean	inRange(char[] chars, char low, char high) True if all the characters in chars are within the set [low,high]
static boolean	inRange(char[] chars, int low, int high) True if all the characters in chars are within the set [low,high]
static boolean	inRange(int codepoint, int low, int high) True if the codepoint is within the set [low,high]
static void	insert(CharSequence s, int i, Codepoint c) Insert a codepoint into the buffer, automatically dealing with surrogate pairs
static void	insert(CharSequence s, int i, int c) Insert a codepoint into the buffer, automatically dealing with surrogate pairs
static boolean	inverseSetContains(int[] aCodepointSet, int value) Treats the specified int array as an Inversion Set and returns true if the value is located within the set.
static boolean	is_ifragment(int codepoint)
static boolean	is_ihost(int codepoint)
static boolean	is_ipath(int codepoint)
static boolean	is_ipathnodelims(int codepoint)
static boolean	is_ipchar(int codepoint)
static boolean	is_ipliteral(int codepoint)
static boolean	is_iprivate(int codepoint)
static boolean	is_iquery(int codepoint)
static boolean	is_iregname(int codepoint)
static boolean	is_iserver(int codepoint)
static boolean	is_iunreserved(int codepoint)
static boolean	is_iuserinfo(int codepoint)
static boolean	is_regname(int codepoint)
static boolean	is_ucschar(int codepoint)
static boolean	isAlpha(Codepoint codepoint) True if the codepoint is part of the ASCII alphabet (a-z, A-Z)
static boolean	isAlpha(int codepoint) True if the codepoint is part of the ASCII alphabet (a-z, A-Z)
static boolean	isAlphaDigit(Codepoint codepoint) True if isAlpha and isDigit both return true
static boolean	isAlphaDigit(int codepoint) True if isAlpha and isDigit both return true
static boolean	isBidi(Codepoint codepoint) True if the codepoint is a bidi control character
static boolean	isBidi(int codepoint) True if the codepoint is a bidi control character
static boolean	isDigit(Codepoint codepoint) True if the codepoint is a digit
static boolean	isDigit(int codepoint) True if the codepoint is a digit
static boolean	isFragment(int codepoint)
static boolean	isGenDelim(int codepoint)
static boolean	isHex(int codepoint)
static boolean	isMark(int codepoint)
static boolean	isPath(int codepoint)
static boolean	isPathNoDelims(int codepoint)
static boolean	isPchar(int codepoint)
static boolean	isPctEnc(int codepoint)
static boolean	isQuery(int codepoint)
static boolean	isReserved(int codepoint)
static boolean	isScheme(int codepoint)
static boolean	isSubDelim(int codepoint)
static boolean	isUnreserved(int codepoint)
static boolean	isUserInfo(int codepoint)
static int	length(AbstractCodepointIterator ci)
static int	length(char[] c) Return the total number of codepoints in the buffer.
static int	length(CharSequence c) Return the total number of codepoints in the buffer.
static void	setChar(CharSequence s, int i, Codepoint c) Set the character at a given location, automatically dealing with surrogate pairs
static void	setChar(CharSequence s, int i, int c) Set the character at a given location, automatically dealing with surrogate pairs
static String	stripBidi(String s) Removes leading and trailing bidi controls from the string
static String	stripBidiInternal(String s) Removes bidi controls from within a string
static void	verify(AbstractCodepointIterator ci, ECodepointProfile profile) Verifies a sequence of codepoints using the specified filter
static void	verify(AbstractCodepointIterator ci, ICodepointFilter filter) Verifies a sequence of codepoints using the specified filter
static void	verify(char[] s, ECodepointProfile profile) Verifies a sequence of codepoints using the specified profile
static void	verify(String s, ECodepointProfile profile) Verifies a sequence of codepoints using the specified profile
static void	verifyNot(char[] array, ECodepointProfile profile) Verifies a sequence of codepoints using the specified profile
static void	verifyNot(ICodepointIterator ci, ECodepointProfile profile) Verifies a sequence of codepoints using the specified profile
static void	verifyNot(ICodepointIterator ci, ICodepointFilter filter) Verifies a sequence of codepoints using the specified filter
static String	wrapBidi(String s, char c) Wrap the string with the specified bidi control

Methods inherited from class java.lang.Object

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

Field Detail

LRE

public static final char LRE

See Also:

Constant Field Values

RLE

public static final char RLE

See Also:

Constant Field Values

LRO

public static final char LRO

See Also:

Constant Field Values

RLO

public static final char RLO

See Also:

Constant Field Values

LRM

public static final char LRM

See Also:

Constant Field Values

RLM

public static final char RLM

See Also:

Constant Field Values

PDF

public static final char PDF

See Also:

Constant Field Values

Method Detail

inRange

public static boolean inRange(char[] chars,
              char low,
              char high)

True if all the characters in chars are within the set [low,high]

inRange

public static boolean inRange(char[] chars,
              int low,
              int high)

True if all the characters in chars are within the set [low,high]

inRange

public static boolean inRange(int codepoint,
              int low,
              int high)

True if the codepoint is within the set [low,high]

getHighSurrogate

public static char getHighSurrogate(int c)

Get the high surrogate for a particular unicode codepoint

getLowSurrogate

public static char getLowSurrogate(int c)

Get the low surrogate for a particular unicode codepoint

codepointAt

@Nonnull
public static Codepoint codepointAt(@Nonnull
                            CharSequence s,
                            int i)

Return the codepoint at the given location, automatically dealing with surrogate pairs

insert

public static void insert(CharSequence s,
          int i,
          @Nonnull
          Codepoint c)

Insert a codepoint into the buffer, automatically dealing with surrogate pairs

insert

public static void insert(@Nonnull
          CharSequence s,
          int i,
          int c)

Insert a codepoint into the buffer, automatically dealing with surrogate pairs

setChar

public static void setChar(@Nonnull
           CharSequence s,
           int i,
           @Nonnull
           Codepoint c)

Set the character at a given location, automatically dealing with surrogate pairs

setChar

public static void setChar(@Nonnull
           CharSequence s,
           int i,
           int c)

Set the character at a given location, automatically dealing with surrogate pairs

length

public static int length(@Nonnull
         CharSequence c)

Return the total number of codepoints in the buffer. Each surrogate pair counts as a single codepoint

length

public static int length(@Nonnull
         char[] c)

Return the total number of codepoints in the buffer. Each surrogate pair counts as a single codepoint

length

public static int length(@Nonnull
         AbstractCodepointIterator ci)

getAsCharArray

@Nonnull
@Nonempty
public static char[] getAsCharArray(int c)

Return the char[] representation of the codepoint, automatically dealing with surrogate pairs

getAsString

@Nonnull
@Nonempty
public static String getAsString(int c)

Return the String representation of the codepoint, automatically dealing with surrogate pairs

stripBidi

@Nullable
public static String stripBidi(@Nullable
                        String s)

Removes leading and trailing bidi controls from the string

stripBidiInternal

@Nonnull
public static String stripBidiInternal(@Nonnull
                               String s)

Removes bidi controls from within a string

wrapBidi

public static String wrapBidi(@Nonnull
              String s,
              char c)

Wrap the string with the specified bidi control

isDigit

public static boolean isDigit(@Nonnull
              Codepoint codepoint)

True if the codepoint is a digit

isDigit

public static boolean isDigit(int codepoint)

True if the codepoint is a digit

isAlpha

public static boolean isAlpha(@Nonnull
              Codepoint codepoint)

True if the codepoint is part of the ASCII alphabet (a-z, A-Z)

isAlpha

public static boolean isAlpha(int codepoint)

True if the codepoint is part of the ASCII alphabet (a-z, A-Z)

isAlphaDigit

public static boolean isAlphaDigit(@Nonnull
                   Codepoint codepoint)

True if isAlpha and isDigit both return true

isAlphaDigit

public static boolean isAlphaDigit(int codepoint)

True if isAlpha and isDigit both return true

isHex

public static boolean isHex(int codepoint)

isBidi

public static boolean isBidi(@Nonnull
             Codepoint codepoint)

True if the codepoint is a bidi control character

isBidi

public static boolean isBidi(int codepoint)

True if the codepoint is a bidi control character

getIndex

@CheckForSigned
public static int getIndex(@Nonnull
                          int[] aCodepointSet,
                          int nValue)

inverseSetContains

public static boolean inverseSetContains(@Nonnull
                         int[] aCodepointSet,
                         int value)

Treats the specified int array as an Inversion Set and returns true if the value is located within the set. This will only work correctly if the values in the int array are monotonically increasing

isPctEnc

public static boolean isPctEnc(int codepoint)

isMark

public static boolean isMark(int codepoint)

isUnreserved

public static boolean isUnreserved(int codepoint)

isReserved

public static boolean isReserved(int codepoint)

isGenDelim

public static boolean isGenDelim(int codepoint)

isSubDelim

public static boolean isSubDelim(int codepoint)

isPchar

public static boolean isPchar(int codepoint)

isPath

public static boolean isPath(int codepoint)

isPathNoDelims

public static boolean isPathNoDelims(int codepoint)

isScheme

public static boolean isScheme(int codepoint)

isUserInfo

public static boolean isUserInfo(int codepoint)

isQuery

public static boolean isQuery(int codepoint)

isFragment

public static boolean isFragment(int codepoint)

is_ucschar

public static boolean is_ucschar(int codepoint)

is_iprivate

public static boolean is_iprivate(int codepoint)

is_iunreserved

public static boolean is_iunreserved(int codepoint)

is_ipchar

public static boolean is_ipchar(int codepoint)

is_ipath

public static boolean is_ipath(int codepoint)

is_ipathnodelims

public static boolean is_ipathnodelims(int codepoint)

is_iquery

public static boolean is_iquery(int codepoint)

is_ifragment

public static boolean is_ifragment(int codepoint)

is_iregname

public static boolean is_iregname(int codepoint)

is_ipliteral

public static boolean is_ipliteral(int codepoint)

is_ihost

public static boolean is_ihost(int codepoint)

is_regname

public static boolean is_regname(int codepoint)

is_iuserinfo

public static boolean is_iuserinfo(int codepoint)

is_iserver

public static boolean is_iserver(int codepoint)

verify

public static void verify(AbstractCodepointIterator ci,
          ICodepointFilter filter)

Verifies a sequence of codepoints using the specified filter

verify

public static void verify(AbstractCodepointIterator ci,
          @Nonnull
          ECodepointProfile profile)

Verifies a sequence of codepoints using the specified filter

verify

public static void verify(@Nullable
          char[] s,
          @Nonnull
          ECodepointProfile profile)

Verifies a sequence of codepoints using the specified profile

verify

public static void verify(@Nullable
          String s,
          @Nonnull
          ECodepointProfile profile)

Verifies a sequence of codepoints using the specified profile

verifyNot

public static void verifyNot(ICodepointIterator ci,
             ICodepointFilter filter)

Verifies a sequence of codepoints using the specified filter

verifyNot

public static void verifyNot(ICodepointIterator ci,
             @Nonnull
             ECodepointProfile profile)

Verifies a sequence of codepoints using the specified profile

verifyNot

public static void verifyNot(char[] array,
             @Nonnull
             ECodepointProfile profile)

Verifies a sequence of codepoints using the specified profile