Class StringGenerator
- java.lang.Object
-
- com.carrotsearch.randomizedtesting.generators.StringGenerator
-
- Direct Known Subclasses:
CodepointSetGenerator
,RealisticUnicodeGenerator
,UnicodeGenerator
public abstract class StringGenerator extends java.lang.Object
AStringGenerator
generates random strings composed of characters. What these characters are and their distribution depends on a subclass.- See Also:
String
-
-
Constructor Summary
Constructors Constructor Description StringGenerator()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description abstract java.lang.String
ofCodePointsLength(java.util.Random r, int minCodePoints, int maxCodePoints)
abstract java.lang.String
ofCodeUnitsLength(java.util.Random r, int minCodeUnits, int maxCodeUnits)
java.lang.String
ofStringLength(java.util.Random r, int minCodeUnits, int maxCodeUnits)
An alias forofCodeUnitsLength(Random, int, int)
.
-
-
-
Method Detail
-
ofStringLength
public java.lang.String ofStringLength(java.util.Random r, int minCodeUnits, int maxCodeUnits)
An alias forofCodeUnitsLength(Random, int, int)
.
-
ofCodeUnitsLength
public abstract java.lang.String ofCodeUnitsLength(java.util.Random r, int minCodeUnits, int maxCodeUnits)
- Parameters:
minCodeUnits
- Minimum number of code units (inclusive).maxCodeUnits
- Maximum number of code units (inclusive).- Returns:
- Returns a string of variable length between
minCodeUnits
(inclusive) andmaxCodeUnits
(inclusive) length. Code units are essentially an equivalent ofchar
type, seeString
class for explanation. - Throws:
java.lang.IllegalArgumentException
- Thrown if the generator cannot emit random string of the given unit length. For example a generator emitting only extended unicodeGenerator plane characters (encoded as surrogate pairs) will not be able to emit an odd number of code units.
-
ofCodePointsLength
public abstract java.lang.String ofCodePointsLength(java.util.Random r, int minCodePoints, int maxCodePoints)
- Parameters:
minCodePoints
- Minimum number of code points (inclusive).maxCodePoints
- Maximum number of code points (inclusive).- Returns:
- Returns a string of variable length between
minCodePoints
(inclusive) andmaxCodePoints
(inclusive) length. Code points are full unicodeGenerator codepoints or an equivalent ofint
type, seeString
class for explanation. The returnedString.length()
may exceedmaxCodeUnits
because certain code points may be encoded as surrogate pairs.
-
-