com.yahoo.memory

Class Util.RandomCodePoints

java.lang.Object

com.yahoo.memory.Util.RandomCodePoints

Enclosing class:

Util

public static class Util.RandomCodePoints
extends Object

Creates random valid Character Code Points (as integers). By definition, valid CodePoints are integers in the range 0 to Character.MAX_CODE_POINT, and exclude the surrogate values. This is used in unit testing and characterization testing of the UTF8 class. Because the characterization tools are in a separate package, this must remain public.

Author:

Lee Rhodes

Constructor Summary

Constructors

Constructor and Description
RandomCodePoints(boolean deterministic)

Method Summary

Modifier and Type	Method and Description
void	fillCodePointArray(int[] cpArr) Fills the given array with random valid Code Points from 0, inclusive, to Character.MAX_CODE_POINT, inclusive.
void	fillCodePointArray(int[] cpArr, int startCP, int endCP) Fills the given array with random valid Code Points from startCP, inclusive, to endCP, exclusive.
int	getCodePoint() Return a single valid random Code Point from 0, inclusive, to Character.MAX_CODE_POINT, inclusive.
int	getCodePoint(int startCP, int endCP) Return a single valid random Code Point from startCP, inclusive, to endCP, exclusive.

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomCodePoints

public RandomCodePoints(boolean deterministic)

Parameters:

deterministic - if true, configure java.util.Random with a fixed seed.

Method Detail

fillCodePointArray

public final void fillCodePointArray(int[] cpArr)

Fills the given array with random valid Code Points from 0, inclusive, to Character.MAX_CODE_POINT, inclusive. The surrogate range, which is from Character.MIN_SURROGATE, inclusive, to Character.MAX_SURROGATE, inclusive, is always excluded.

Parameters:

cpArr - the array to fill

fillCodePointArray

public final void fillCodePointArray(int[] cpArr,
                                     int startCP,
                                     int endCP)

Fills the given array with random valid Code Points from startCP, inclusive, to endCP, exclusive. The surrogate range, which is from Character.MIN_SURROGATE, inclusive, to Character.MAX_SURROGATE, inclusive, is always excluded.

Parameters:

cpArr - the array to fill

startCP - the starting Code Point, included.

endCP - the ending Code Point, excluded. This value cannot exceed 0x110000.

getCodePoint

public final int getCodePoint()

Return a single valid random Code Point from 0, inclusive, to Character.MAX_CODE_POINT, inclusive. The surrogate range, which is from Character.MIN_SURROGATE, inclusive, to Character.MAX_SURROGATE, inclusive, is always excluded.

Returns:

a single valid random CodePoint.

getCodePoint

public final int getCodePoint(int startCP,
                              int endCP)

Return a single valid random Code Point from startCP, inclusive, to endCP, exclusive. The surrogate range, which is from Character.MIN_SURROGATE, inclusive, to Character.MAX_SURROGATE, inclusive, is always excluded.

Parameters:

startCP - the starting Code Point, included.

endCP - the ending Code Point, excluded. This value cannot exceed 0x110000.

Returns:

a single valid random CodePoint.