KernDX

Appearance

UTIL_Random ​

Class · Group: Utilities

apex
global inherited sharing class UTIL_Random

Generates random values across multiple data types for testing and development, including numbers, strings, UUIDs, and mock Salesforce IDs.

Since: 1.0

Example:

apex
String uuid = UTIL_Random.randomUUID();
String email = UTIL_Random.randomEmail();
Integer number = UTIL_Random.nextInteger(1, 100);
Id mockAccountId = UTIL_Random.randomId(Account.SObjectType);

Methods ​

MethodDescription
global static Boolean nextBoolean()Produces a random boolean by mapping a binary integer result to true or false.
global static Integer nextInteger(Integer upperBound)Produces a random integer from zero up to the given ceiling.
global static Integer nextInteger(Integer lowerBound, Integer upperBound)Produces a random integer between the specified floor and ceiling, both inclusive.
global static String random(Integer length)Builds a random string of the requested length from the printable ASCII character set (codes 32-126).
global static String random(Integer length, String characterSet)Builds a random string of the requested length by sampling from the supplied character set.
global static String randomAlphabetic(Integer length)Builds a random string of the requested length using only Latin letters (a-z, A-Z).
global static String randomAlphanumeric(Integer length)Builds a random string of the requested length using Latin letters and decimal digits (a-z, A-Z, 0-9).
global static Date randomDate()Produces a random date falling between the Unix epoch (1970-01-01) and the current day.
global static Datetime randomDateTime()Produces a random datetime falling between the Unix epoch (1970-01-01) and the current moment.
global static Decimal randomDecimal()Produces a random decimal value with two digits after the decimal point.
global static Decimal randomDecimal(Integer scale)Produces a random decimal with a standard digit count and the caller-specified fractional precision.
global static Decimal randomDecimal(Integer length, Integer scale)Produces a random decimal with a caller-specified whole-number digit count and fractional precision.
global static String randomDescription()Produces a random alphabetic string exactly 40 characters long, suitable for description fields.
global static String randomEmail()Produces a random, realistic-looking email address by combining name components with a randomly selected provider domain.
global static Id randomId(SObjectType sObjectType)Constructs a mock 18-character Salesforce ID based on the key prefix of the supplied SObjectType, useful for unit tests that need fake record IDs.
global static Integer randomInteger()Produces a random integer with a standard length of 6 digits.
global static Integer randomInteger(Integer upperBound)Produces a random non-negative integer up to the specified ceiling.
global static Integer randomIntegerOfLength(Integer requiredLength)Produces a random integer with exactly the specified number of digits.
global static String randomName()Produces a random alphabetic string with a standard length of 10 characters.
global static String randomNumber()Produces a random numeric string with a standard length of 6 digits.
global static String randomNumeric(Integer length)Builds a random string of the requested length using only decimal digit characters (0-9).
global static String randomPhoneNumber()Produces a random international phone number in the format '+[countryCode] ([areaCode]) [part1]-[part2]'.
global static String randomUUID()Produces a universally unique identifier in the standard 8-4-4-4-12 hexadecimal format.

Method Details ​

nextBoolean ​

apex
global static Boolean nextBoolean()

Produces a random boolean by mapping a binary integer result to true or false.

Returns: Boolean - A randomly selected boolean value.

Since: 1.0

Example:

apex
Boolean randomBool = UTIL_Random.nextBoolean();
System.debug(randomBool); // Outputs: true or false

nextInteger ​

apex
global static Integer nextInteger(Integer upperBound)

Produces a random integer from zero up to the given ceiling.

Parameters:

  • upperBound (Integer) - The maximum value (inclusive).

Returns: Integer - An integer between 0 and the absolute value of upperBound.

Since: 1.0

Example:

apex
Integer randomInt = UTIL_Random.nextInteger(100);
System.debug(randomInt); // Outputs: e.g., 42

nextInteger ​

apex
global static Integer nextInteger(Integer lowerBound, Integer upperBound)

Produces a random integer between the specified floor and ceiling, both inclusive.

Parameters:

  • lowerBound (Integer) - The minimum value (inclusive).
  • upperBound (Integer) - The maximum value (inclusive).

Returns: Integer - An integer within the specified boundaries.

Since: 1.0

Example:

apex
Integer randomInt = UTIL_Random.nextInteger(10, 20);
System.debug(randomInt); // Outputs: e.g., 15

random ​

apex
global static String random(Integer length)

Builds a random string of the requested length from the printable ASCII character set (codes 32-126).

Parameters:

  • length (Integer) - How many characters the result should contain.

Returns: String - A random printable-ASCII string, or an empty string when length is non-positive.

Since: 1.0

Example:

apex
String randomString = UTIL_Random.random(10);
System.debug(randomString); // Outputs: e.g., "Kj#9mP$2vQ"

random ​

apex
global static String random(Integer length, String characterSet)

Builds a random string of the requested length by sampling from the supplied character set.

Parameters:

  • length (Integer) - How many characters the result should contain.
  • characterSet (String) - The pool of characters to draw from.

Returns: String - A random string composed of characters from the set, or an empty string when length is non-positive.

Since: 1.0

Example:

apex
String randomCustom = UTIL_Random.random(5, 'ABC');
System.debug(randomCustom); // Outputs: e.g., "ABCCB"

randomAlphabetic ​

apex
global static String randomAlphabetic(Integer length)

Builds a random string of the requested length using only Latin letters (a-z, A-Z).

Parameters:

  • length (Integer) - How many characters the result should contain.

Returns: String - A random alphabetic string, or an empty string when length is non-positive.

Since: 1.0

Example:

apex
String randomAlpha = UTIL_Random.randomAlphabetic(6);
System.debug(randomAlpha); // Outputs: e.g., "KjmPqR"

randomAlphanumeric ​

apex
global static String randomAlphanumeric(Integer length)

Builds a random string of the requested length using Latin letters and decimal digits (a-z, A-Z, 0-9).

Parameters:

  • length (Integer) - How many characters the result should contain.

Returns: String - A random alphanumeric string, or an empty string when length is non-positive.

Since: 1.0

Example:

apex
String randomAlphanumeric = UTIL_Random.randomAlphanumeric(8);
System.debug(randomAlphanumeric); // Outputs: e.g., "Kj9mP2vQ"

randomDate ​

apex
global static Date randomDate()

Produces a random date falling between the Unix epoch (1970-01-01) and the current day.

Returns: Date - A Date that is never in the future.

Since: 1.0

Example:

apex
Date randomDate = UTIL_Random.randomDate();

randomDateTime ​

apex
global static Datetime randomDateTime()

Produces a random datetime falling between the Unix epoch (1970-01-01) and the current moment.

Returns: Datetime - A Datetime that is never in the future.

Since: 1.0

Example:

apex
Datetime randomDt = UTIL_Random.randomDateTime();

randomDecimal ​

apex
global static Decimal randomDecimal()

Produces a random decimal value with two digits after the decimal point.

Returns: Decimal - A Decimal such as 45.67.

Since: 1.0

Example:

apex
Decimal randomDec = UTIL_Random.randomDecimal();

randomDecimal ​

apex
global static Decimal randomDecimal(Integer scale)

Produces a random decimal with a standard digit count and the caller-specified fractional precision.

Parameters:

  • scale (Integer) - The number of digits after the decimal point.

Returns: Decimal - A Decimal with the requested precision.

Since: 1.0

Example:

apex
Decimal randomDec = UTIL_Random.randomDecimal(2);

randomDecimal ​

apex
global static Decimal randomDecimal(Integer length, Integer scale)

Produces a random decimal with a caller-specified whole-number digit count and fractional precision.

Parameters:

  • length (Integer) - The magnitude of digits before the decimal point.
  • scale (Integer) - The number of digits after the decimal point.

Returns: Decimal - A Decimal with the requested scale.

Since: 1.0

Example:

apex
Decimal randomDec = UTIL_Random.randomDecimal(4, 2);

randomDescription ​

apex
global static String randomDescription()

Produces a random alphabetic string exactly 40 characters long, suitable for description fields.

Returns: String - A 40-character alphabetic string.

Since: 1.0

Example:

apex
String randomDesc = UTIL_Random.randomDescription();

randomEmail ​

apex
global static String randomEmail()

Produces a random, realistic-looking email address by combining name components with a randomly selected provider domain.

Returns: String - A randomly composed email address such as 'john.doe@gmail.com'.

Since: 1.0

Example:

apex
String randomEmail = UTIL_Random.randomEmail();

randomId ​

apex
global static Id randomId(SObjectType sObjectType)

Constructs a mock 18-character Salesforce ID based on the key prefix of the supplied SObjectType, useful for unit tests that need fake record IDs.

Parameters:

  • sObjectType (SObjectType) - The SObject type whose key prefix seeds the mock ID.

Returns: Id - A synthetic 18-character Salesforce ID.

Throws:

Since: 1.0

Example:

apex
Id mockId = UTIL_Random.randomId(Account.SObjectType);
System.debug(mockId); // Outputs: e.g., "00100000000lACzAAM"

randomInteger ​

apex
global static Integer randomInteger()

Produces a random integer with a standard length of 6 digits.

Returns: Integer - A 6-digit random integer such as 789234.

Since: 1.0

Example:

apex
Integer randomInt = UTIL_Random.randomInteger();

randomInteger ​

apex
global static Integer randomInteger(Integer upperBound)

Produces a random non-negative integer up to the specified ceiling.

Parameters:

  • upperBound (Integer) - The inclusive maximum for the generated value.

Returns: Integer - A random integer between 0 and upperBound, or null when upperBound is null.

Since: 1.0

Example:

apex
Integer randomInt = UTIL_Random.randomInteger(100);
System.debug(randomInt); // Outputs: e.g., 42

randomIntegerOfLength ​

apex
global static Integer randomIntegerOfLength(Integer requiredLength)

Produces a random integer with exactly the specified number of digits.

Parameters:

  • requiredLength (Integer) - The exact digit count for the generated integer.

Returns: Integer - An integer guaranteed to have the requested number of digits.

Since: 1.0

Example:

apex
Integer randomInt = UTIL_Random.randomIntegerOfLength(5);

randomName ​

apex
global static String randomName()

Produces a random alphabetic string with a standard length of 10 characters.

Returns: String - A 10-character alphabetic string.

Since: 1.0

Example:

apex
String randomName = UTIL_Random.randomName();

randomNumber ​

apex
global static String randomNumber()

Produces a random numeric string with a standard length of 6 digits.

Returns: String - A 6-character numeric string.

Since: 1.0

Example:

apex
String randomNum = UTIL_Random.randomNumber();

randomNumeric ​

apex
global static String randomNumeric(Integer length)

Builds a random string of the requested length using only decimal digit characters (0-9).

Parameters:

  • length (Integer) - How many characters the result should contain.

Returns: String - A random numeric string, or an empty string when length is non-positive.

Since: 1.0

Example:

apex
String randomNum = UTIL_Random.randomNumeric(5);
System.debug(randomNum); // Outputs: e.g., "39281"

randomPhoneNumber ​

apex
global static String randomPhoneNumber()

Produces a random international phone number in the format '+[countryCode] ([areaCode]) [part1]-[part2]'.

Returns: String - A formatted phone number such as '+123 (456) 789-0123'.

Since: 1.0

Example:

apex
String randomPhone = UTIL_Random.randomPhoneNumber();

randomUUID ​

apex
global static String randomUUID()

Produces a universally unique identifier in the standard 8-4-4-4-12 hexadecimal format.

Returns: String - A freshly generated UUID string.

Since: 1.0

Example:

apex
String uuid = UTIL_Random.randomUUID();
System.debug(uuid); // Outputs: e.g., "550e8400-e29b-41d4-a716-446655440000"