Package com.storedobject.common

Class StringUtility

java.lang.Object

com.storedobject.common.StringUtility

Direct Known Subclasses:

StringUtility

public class StringUtility
extends Object

String utility functions.

Author:

Syam

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	StringUtility.List	A specialized implementation of ArrayList<String> that initializes its elements based on an input array of strings.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	StringUtility()	A utility class providing a collection of static methods for performing various operations and manipulations on strings.

Method Summary

Modifier and Type	Method	Description
static String[]	append(String[] a, String element)	Append a new element to an array.
static String	bitsValue(int value, StringList valueLabels)	Converts the bits in the given integer value into a comma-separated string based on the corresponding labels in the provided list.
static String	bitsValue(int value, String[] valueLabels)	Converts an integer value into a string representation using the provided array of value labels.
static <T extends List<String>> T	collect(T list, StringList items)	Adds all elements from the specified StringList to the provided list and returns the updated list.
static <T extends List<String>> T	collect(T list, String[] items)	Adds the elements from the specified array to the given list.
static String[]	concat(String[] first, String[] second)	Concatenate two string arrays.
static String[]	copy(Object[] objects)	Get a duplicate string array copy of the array passed.
static int	distanceLevenshtein(String s, String t)	Find the Levenshtein distance between two strings.
static String	encodeForXML(Object obj)	Encode and return the string representation of the object passed.
static boolean	equals(CharSequence one, CharSequence two)	See if 2 character sequences contain the same sequence of characters
static String	fill(String source, StringFiller filler)	Replace variables in the source string with values returned by the filler.
int	findNonWhitespace(String s, int from)	Find the next non-whitespace position.
int	findWhitespace(String s, int from)	Find the next whitespace position.
static String	firstCaps(String s)	Convert a string to a proper case (the first letter of each word will be capitalized).
static String[]	firstCaps(String[] a)	Convert each element of the string array to a proper case (the first letter of each word will be capitalized).
static String	format(double value)	Formats a double value as a numeric string.
static String	format(double value, boolean separated)	Formats a double value as a numeric string.
static String	format(double value, int decimals)	Formats a double value as a numeric string with a thousand separation.
static String	format(double value, int decimals, boolean separated)	Formats a double value as a numeric string with a thousand separation.
static String	format(String s, int decimals, boolean separated)	Formats a string as a numeric string with the thousand separations.
static String	formatIndian(double value, boolean separated)	Formats a double value as a numeric string (Indian style).
static String	formatIndian(double value, int decimals, boolean separated)	Formats a double value as a numeric string with thousands separation (Indian style).
static String	formatIndian(String s, int decimals, boolean separated)	Formats a string as a numeric string with a thousand separation (Indian style).
static int	getCharCount(String text, char c)	Gets the number of occurrences of a given character in the string.
static String[]	getCSV(BufferedReader reader)	Reads a single line of CSV (Comma-Separated Values) data from a BufferedReader and parses it into an array of strings.
static int	getStringCount(String text, String pattern)	Gets the number of occurrences of a given string in this string.
static String	getTrace(Thread thread)	Retrieves the stack trace of the specified thread as a string.
static String	getTrace(Throwable error)	Retrieves a string representation of the stack trace for the provided throwable.
static int	indexOf(String[] a, String element)	Find the index of an element in an array.
static int	indexOf(String[] a, String element, int from)	Find the index of an element in an array.
static int	indexOf(String[] a, String element, int from, int to)	Find the index of an element in an array.
static String[]	insert(String[] a, String element, int index)	Insert a new element at the given index.
static boolean	isBlank(String s)	Check if a String contains only space characters
static boolean	isDigit(String s)	Check if a String contains only digits
static boolean	isLetter(String s)	Check if a String contains only letters
static boolean	isLetterOrDigit(String s)	Check if a String contains only letters and digits
static boolean	isModulus11(long number)	Check the number passed to see if it ends with a modulus 11 check digit.
static boolean	isModulus11(String alphanumeric)	Check the alphanumeric string passed to see if it ends with a modulus 11 check digit.
static boolean	isNumber(String s)	Check if a String contains a numeric value or not.
static boolean	isWhite(char c)	Check if the character is a white space or not
static boolean	isWhite(String s)	Check if a String contains only white space characters
static String	makeLabel(String s)	Make a label by inserting a space before each capital letter.
static String	makeLabel(String s, boolean lowerPropositions)	Make a label by inserting a space before each capital letter.
static String	makeString(int length)	Make a String of spaces.
static String	makeString(String s, int length)	Make a new String by padding spaces to the String passed
static String	makeString(String s, int length, boolean padLeft)	Make a new String by padding spaces to the String passed
static String	makeString(String s, int length, char padChar, boolean padLeft)	Make a new String by padding the padChar to the String passed
static String	md5(String input)	MD5 encryption
static String	minutesToAMPM(int time)	Converts minutes of the day to human-readable AM/PM string.
static String	minutesToString(int duration)	Converts time duration to human-readable string "hours:minutes".
static int	modulus11(long number)	Compute the modulus 11 check digit for the number passed.
static int	modulus11(String alphanumeric)	Compute the modulus 11 check digit for the alphanumeric string passed.
static String	pack(String s)	Pack a string by removing white spaces.
static String[]	pack(String[] s)	Pack all the strings in an array by removing white spaces.
static String	padLeft(String s, int length)	Left pad a String with spaces
static String	padLeft(String s, int length, char padChar)	Left pad a String with the padChar passed
static String	padRight(String s, int length)	Right pad a String with spaces
static String	padRight(String s, int length, char padChar)	Right pad a String with the padChar passed
static Properties	parseToProperties(String[] args)	Parse the string array into "properties".
static String[]	remove(String[] a, String element)	Remove the first instance of an element from an array.
static String[]	removeAll(String[] a, String element)	Remove all instances of an element from an array.
static String[]	removeNulls(String[] s)	Remove null values from the array of Strings.
static String	replaceOutside(String text, CharSequence target, CharSequence replacement)	Replaces all occurrences of 'target' with 'replacement' outside the quoted portion (single or double quotes).
static String	replicate(String s, int times)	Replicate a String several times
static boolean	same(CharSequence one, CharSequence two)	Compares two CharSequence objects for equality by checking if they have the same length and identical characters at each corresponding position.
static String	smoothen(String s)	Smoothen a string by trimming and replacing double spaces with single space.
static String	soundex(String string)	Converts a string into a 4-character soundex code.
static String[]	split(String s, int length)	Split the string at the given length into an array.
static String	stringify(Object object)	Stringify the object
static String[]	tagDuplicates(String[] s)	Tag each element of a String array if it is a duplicate.
static List<String>	tagDuplicates(List<String> s)	Tag each element of a String list if it is a duplicate.
static String[]	toArray(List<?> list)	Convert the list to a String array.
static String	toCamelCase(String text)	Convert a string to camelcase.
static char[]	toCharArray(String[] s)	Get a char array from a String array.
static String	toHex(byte[] bytes)	Convert a byte array into a String of hex values.
static char[]	toLowerCase(char[] s)	Convert to lower case.
static String[]	toLowerCase(String[] s)	Convert to lower case.
static int[]	toNumericRange(String s)	Convert a range string to an int array.
static String	toRangeString(int[] n)	Convert an int array into a range string.
static String	toRangeString(Collection<Integer> list)	Convert an integer list to a range string.
static String	toString(InputStream stream)	Converts the content of the given InputStream into a String.
static String	toString(Reader reader)	Converts the content of a Reader into a String.
static String	toString(Object message)	Converts the provided object into its string representation.
static char[]	toUpperCase(char[] s)	Convert to the upper case.
static String[]	toUpperCase(String[] s)	Convert to the upper case.
static String[]	trim(String[] s)	Trim each element of a String array
static String	trimLeft(String s)	Left trim a string
static String[]	trimLeft(String[] s)	Left trim each element of a String array
static String	trimRight(String s)	Right trim a string
static String[]	trimRight(String[] s)	Right trim each element of a String array
static String	words(Number value)	Converts a numeric value into words.
static String	words(BigDecimal value)	Converts a numeric value into words.
static String	words(BigInteger value)	Converts a numeric value into words.
static String	wordsIndian(BigDecimal value)	Converts a numeric value into words in Indian format.
static String	wordsIndian(BigInteger value)	Converts a numeric value into words in Indian format.

Methods inherited from class java.lang.Object

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

Constructor Details

StringUtility

protected StringUtility()

A utility class providing a collection of static methods for performing various operations and manipulations on strings. This constructor is protected to prevent direct instantiation of the utility class, ensuring that it is used in a static context only.

Method Details

toCamelCase

public static String toCamelCase(String text)

Convert a string to camelcase.

Parameters:

text - Text to convert.

Returns:

Converted text.

toLowerCase

public static String[] toLowerCase(String[] s)

Convert to lower case.

Parameters:

s - String array to be converted.

Returns:

Array

toUpperCase

public static String[] toUpperCase(String[] s)

Convert to the upper case.

Parameters:

s - String array to be converted.

Returns:

Array

toLowerCase

public static char[] toLowerCase(char[] s)

Convert to lower case.

Parameters:

s - Char array to be converted.

Returns:

Array

toUpperCase

public static char[] toUpperCase(char[] s)

Convert to the upper case.

Parameters:

s - Char array to be converted.

Returns:

Array

tagDuplicates

public static String[] tagDuplicates(String[] s)

Tag each element of a String array if it is a duplicate. For example, if the array is { "Name", "ShortName", "Name", "Test", "Name" }, it will become { "Name", "ShortName", "Name (2)", "Test", "Name (3)" }. Null values will be untouched.

Parameters:

s - String array to be tagged

Returns:

Array

tagDuplicates

public static List<String> tagDuplicates(List<String> s)

Tag each element of a String list if it is a duplicate. For example, if the list is [ "Name", "ShortName", "Name", "Test", "Name" ], it will become [ "Name", "ShortName", "Name (2)", "Test", "Name (3)" ]. Null values will be untouched.

Parameters:

s - String list to be tagged

Returns:

Array

toArray

public static String[] toArray(List<?> list)

Convert the list to a String array. Null values will be converted to empty strings.

Parameters:

list - List to be converted

Returns:

String array.

trim

public static String[] trim(String[] s)

Trim each element of a String array

Parameters:

s - String array to be trimmed

Returns:

Array

trimRight

public static String[] trimRight(String[] s)

Right trim each element of a String array

Parameters:

s - String array to be trimmed

Returns:

Array

trimLeft

public static String[] trimLeft(String[] s)

Left trim each element of a String array

Parameters:

s - String array to be trimmed

Returns:

Array

trimRight

public static String trimRight(String s)

Right trim a string

Parameters:

s - String to be trimmed

Returns:

The result String

trimLeft

public static String trimLeft(String s)

Left trim a string

Parameters:

s - String to be trimmed

Returns:

The result String

replicate

public static String replicate(String s,
 int times)

Replicate a String several times

Parameters:

s - String to be replicated

times - Number of times to replicate

Returns:

The result String

padRight

public static String padRight(String s,
 int length)

Right pad a String with spaces

Parameters:

s - String to be padded. A null String is treated as "".

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed, one depending on this parameter.

Returns:

The result String

padRight

public static String padRight(String s,
 int length,
 char padChar)

Right pad a String with the padChar passed

Parameters:

s - String to be padded. A null String is treated as "".

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed, one depending on this parameter.

padChar - The character to be used for padding.

Returns:

The result String

padLeft

public static String padLeft(String s,
 int length)

Left pad a String with spaces

Parameters:

s - String to be padded. A null String is treated as "".

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed, one depending on this parameter.

Returns:

The result String

padLeft

public static String padLeft(String s,
 int length,
 char padChar)

Left pad a String with the padChar passed

Parameters:

s - String to be padded. A null String is treated as "".

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed, one depending on this parameter.

padChar - The character to be used for padding.

Returns:

The result String

makeString

public static String makeString(int length)

Make a String of spaces.

Parameters:

length - The length of the resulting String

Returns:

The result String

makeString

public static String makeString(String s,
 int length)

Make a new String by padding spaces to the String passed

Parameters:

s - Input string

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed one, depending on this parameter.

Returns:

The result String

makeString

public static String makeString(String s,
 int length,
 boolean padLeft)

Make a new String by padding spaces to the String passed

Parameters:

s - Input string

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed one, depending on this parameter.

padLeft - If passed "true", left padding will happen, otherwise padding will happen on the right

Returns:

The result String

makeString

public static String makeString(String s,
 int length,
 char padChar,
 boolean padLeft)

Make a new String by padding the padChar to the String passed

Parameters:

s - Input string

length - Length of the String after padding. Warning: The resulting String may be shorter than the passed one, depending on this parameter.

padChar - The character to be used for padding.

padLeft - If passed "true", left padding will happen, otherwise padding will happen on the right

Returns:

The result String

smoothen

public static String smoothen(String s)

Smoothen a string by trimming and replacing double spaces with single space. Null will be converted to "". Also, output will be trimmed.

Parameters:

s - Input string

Returns:

Smoothened string

pack

public static String pack(String s)

Pack a string by removing white spaces. Note: Null value is converted to "".

Parameters:

s - String to be packed.

Returns:

String value after removing all white spaces.

pack

public static String[] pack(String[] s)

Pack all the strings in an array by removing white spaces. Note: Null values are converted to "".

Parameters:

s - String array to be packed.

Returns:

Converted array value after removing all white spaces from the elements.

removeNulls

public static String[] removeNulls(String[] s)

Remove null values from the array of Strings.

Parameters:

s - String array from which null values need to be removed.

Returns:

Converted array containing no null values. Array length may shrink because of the removals.

toHex

public static String toHex(byte[] bytes)

Convert a byte array into a String of hex values. Each is converted to 2 hex characters. For example, StringUtility.toHex(new byte[ ] { 10, 17, 19, 4, 11 }) will return "0A1113040B".

Parameters:

bytes - The byte array to be converted.

Returns:

The result String

isBlank

public static boolean isBlank(String s)

Check if a String contains only space characters

Parameters:

s - String to be checked

Returns:

True if the String contains only spaces, otherwise false.

isWhite

public static boolean isWhite(String s)

Check if a String contains only white space characters

Parameters:

s - String to be checked

Returns:

True if the String contains only white spaces, otherwise false.

isWhite

public static boolean isWhite(char c)

Check if the character is a white space or not

Parameters:

c - Character to be checked.

Returns:

True if the character is a white space, otherwise false.

isLetterOrDigit

public static boolean isLetterOrDigit(String s)

Check if a String contains only letters and digits

Parameters:

s - String to be checked

Returns:

True if the String contains only letters and digits, otherwise false.

isLetter

public static boolean isLetter(String s)

Check if a String contains only letters

Parameters:

s - String to be checked

Returns:

True if the String contains only letters, otherwise false.

isDigit

public static boolean isDigit(String s)

Check if a String contains only digits

Parameters:

s - String to be checked

Returns:

True if the String contains only digits, otherwise false.

isNumber

public static boolean isNumber(String s)

Check if a String contains a numeric value or not.

Parameters:

s - String to be checked

Returns:

True if the String contains a proper numeric value. (Can contain an optional minus '-' sign and a decimal point).

firstCaps

public static String firstCaps(String s)

Convert a string to a proper case (the first letter of each word will be capitalized).

Parameters:

s - String to be converted.

Returns:

Converted string.

firstCaps

public static String[] firstCaps(String[] a)

Convert each element of the string array to a proper case (the first letter of each word will be capitalized).

Parameters:

a - String array to be converted.

Returns:

Array

findWhitespace

public int findWhitespace(String s,
 int from)

Find the next whitespace position.

Parameters:

s - String to be searched.

from - The position from which the search should start.

Returns:

The next whitespace position or the string length if nothing found.

findNonWhitespace

public int findNonWhitespace(String s,
 int from)

Find the next non-whitespace position.

Parameters:

s - String to be searched.

from - The position from which the search should start.

Returns:

The next non-whitespace position or the string length if nothing found.

minutesToString

public static String minutesToString(int duration)

Converts time duration to human-readable string "hours:minutes".

Parameters:

duration - Time duration to convert in minutes.

Returns:

Human-readable string. Example: 63 will be converted to "01:03".

minutesToAMPM

public static String minutesToAMPM(int time)

Converts minutes of the day to human-readable AM/PM string.

Parameters:

time - Time to convert in minutes (will be converted to the range 0 <= minutes < 1448).

Returns:

Human-readable string. Example: 63 will be converted to "01:03 AM".

makeLabel

public static String makeLabel(String s,
 boolean lowerPropositions)

Make a label by inserting a space before each capital letter. Also, all dash characters ("-", "_") are converted into " - ". Single quotes will be copied as such. If "as" keyword is found, the word sequences after that keyword will be used for generating the label.

Examples: "ShortName" => "Short Name", "CountryName" => "Country Name", "CountryOfDestination as Shipment Country" => "Shipment Country", "KGB" => "KGB", "KGBAgent" => "KGB Agent", "eDocument" => "eDocument", "eGovernanceInitiative" => "eGovernance Initiative", "Document_PartI" => "Document - Part I.

Also,

(1) class casting type constructs will be removed. Example: "(com.storedobject.core.Person)Employee" => "Employee"

(2) "A.B.C." => "A.B.C.", "Animal.Lion" => "Lion" (because the letter just before ".Lion" is in small-case).

Parameters:

s - String to be converted.

lowerPropositions - Whether to convert propositions to lower case or not.

Returns:

Converted string.

makeLabel

public static String makeLabel(String s)

Make a label by inserting a space before each capital letter. Also, all dash characters ("-", "_") are converted into " - ". Single quotes will be copied as such. If "as" keyword is found, the word sequences after that keyword will be used for generating the label.

Examples: "ShortName" => "Short Name", "CountryName" => "Country Name", "CountryOfDestination as Shipment Country" => "Shipment Country", "KGB" => "KGB", "KGBAgent" => "KGB Agent", "eDocument" => "eDocument", "eGovernanceInitiative" => "eGovernance Initiative", "Document_PartI" => "Document - Part I.

Also,

(1) class casting type constructs will be removed. Example: "(com.storedobject.core.Person)Employee" => "Employee"

(2) "A.B.C." => "A.B.C.", "Animal.Lion" => "Lion" (because the letter just before ".Lion" is in small-case).

Parameters:

s - String to be converted.

Returns:

Converted string.

toRangeString

public static String toRangeString(Collection<Integer> list)

Convert an integer list to a range string. For example, { 1, 2, 3, 5, 7, 8, 9 } will be converted to "1 - 3, 5, 7 - 9".

Parameters:

list - List of numbers to be converted.

Returns:

Range string

toRangeString

public static String toRangeString(int[] n)

Convert an int array into a range string. For example, an array { 1, 2, 3, 5, 7, 8, 9 } will be converted to "1 - 3, 5, 7 - 9".

Parameters:

n - int array of numbers to be converted.

Returns:

Range string

toNumericRange

public static int[] toNumericRange(String s)

Convert a range string to an int array. For example, "1 - 3, 5, 7 - 9" will be converted to an array { 1, 2, 3, 5, 7, 8, 9 }.

Parameters:

s - String to be converted.

Returns:

int array containing the numbers. Null will be returned if the parameter passed contains errors.

soundex

public static String soundex(String string)

Converts a string into a 4-character soundex code.

Parameters:

string - The string to be converted.

Returns:

The soundex coded string.

getCharCount

public static int getCharCount(String text,
 char c)

Gets the number of occurrences of a given character in the string.

Parameters:

text - String to be scanned.

c - Character to look for.

Returns:

Occurrences

getStringCount

public static int getStringCount(String text,
 String pattern)

Gets the number of occurrences of a given string in this string.

Parameters:

text - String to be scanned.

pattern - String to look for.

Returns:

Occurrences

replaceOutside

public static String replaceOutside(String text,
 CharSequence target,
 CharSequence replacement)

Replaces all occurrences of 'target' with 'replacement' outside the quoted portion (single or double quotes).

Parameters:

text - String to operate on.

target - Target sequence to replace

replacement - Replacement text

Returns:

Replaced string

encodeForXML

public static String encodeForXML(Object obj)

Encode and return the string representation of the object passed. This encoding is useful for creating strings that can be used in XML texts. That is, it replaces characters such as "<", "&", ">" etc. the respective encoded values "&lt;", "&amp;", "&gt;" etc.

Parameters:

obj - The object to convert.

Returns:

XML encoded string.

modulus11

public static int modulus11(long number)

Compute the modulus 11 check digit for the number passed.

Parameters:

number - Number

Returns:

Check a digit. -1 is returned for invalid numbers.

modulus11

public static int modulus11(String alphanumeric)

Compute the modulus 11 check digit for the alphanumeric string passed.

Parameters:

alphanumeric - Input

Returns:

Check a digit. -1 is returned for invalid numbers and -2 is returned for invalid strings.

isModulus11

public static boolean isModulus11(String alphanumeric)

Check the alphanumeric string passed to see if it ends with a modulus 11 check digit.

Parameters:

alphanumeric - Input

Returns:

True or false.

isModulus11

public static boolean isModulus11(long number)

Check the number passed to see if it ends with a modulus 11 check digit.

Parameters:

number - Number

Returns:

True or false.

stringify

public static String stringify(Object object)

Stringify the object

Parameters:

object - Object to be stringified.

Returns:

String obtained from object.toString(). If an object is null or toString method generates errors, a zero-length string will return.

copy

public static String[] copy(Object[] objects)

Get a duplicate string array copy of the array passed. Each element from the source array will be stringified.

Parameters:

objects - Array of any object copy.

Returns:

Copy of the array as a string array. If the input is null, the output will also be null. Null elements in the source array will generate a null element in the output array.

toCharArray

public static char[] toCharArray(String[] s)

Get a char array from a String array.

Parameters:

s - Array to be converted.

Returns:

character array created by taking the first characters of the String array. For null values and values of length zeros, a space is set for the corresponding character values.

insert

public static String[] insert(String[] a,
 String element,
 int index)

Insert a new element at the given index.

Parameters:

a - Array for inserting the new element.

element - Element to be inserted.

index - Index

Returns:

Resultant array with a length greater than the length of the array passed.

append

public static String[] append(String[] a,
 String element)

Append a new element to an array.

Parameters:

a - Array to be increased.

element - Element to be added.

Returns:

Resultant array with a length greater than the length of the array passed.

remove

public static String[] remove(String[] a,
 String element)

Remove the first instance of an element from an array.

Parameters:

a - Array.

element - Element to be removed.

Returns:

Resultant array.

removeAll

public static String[] removeAll(String[] a,
 String element)

Remove all instances of an element from an array.

Parameters:

a - Array.

element - Element to be removed.

Returns:

Resultant array.

concat

public static String[] concat(String[] first,
 String[] second)

Concatenate two string arrays.

Parameters:

first - First string.

second - Second string.

Returns:

Concatenated string.

indexOf

public static int indexOf(String[] a,
 String element)

Find the index of an element in an array.

Parameters:

a - Array.

element - Element to be searched.

Returns:

First index of the element. -1 is returned if the array is null or the element is not found.

indexOf

public static int indexOf(String[] a,
 String element,
 int from)

Find the index of an element in an array.

Parameters:

a - Array.

element - Element to be searched.

from - From index

Returns:

First index of the element. -1 is returned if the array is null or the element is not found.

indexOf

public static int indexOf(String[] a,
 String element,
 int from,
 int to)

Find the index of an element in an array.

Parameters:

a - Array.

element - Element to be searched.

from - From index

to - To index

Returns:

First index of the element. -1 is returned if the array is null or the element is not found.

split

public static String[] split(String s,
 int length)

Split the string at the given length into an array. New line characters will be treated as if splitting is needed at that position. An attempt is made to split at word boundaries if possible. "\r" (carriage return) characters will be removed.

Parameters:

s - String to split.

length - Length at which the split happens.

Returns:

Array of strings containing each part of the string.

parseToProperties

public static Properties parseToProperties(String[] args)
                                    throws SOException

Parse the string array into "properties". This is useful to parse "command line" parameters.

Parameters:

args - Argument list as a string array.

Returns:

Properties containing all the argument values passed as the array.

Throws:

SOException - if anything in the argument does not look like a "command line" parameter.

distanceLevenshtein

public static int distanceLevenshtein(String s,
 String t)

Find the Levenshtein distance between two strings.

Parameters:

s - First string

t - Second string

Returns:

Levenshtein distance

bitsValue

public static String bitsValue(int value,
 String[] valueLabels)

Converts an integer value into a string representation using the provided array of value labels. Each bit in the integer value is matched with a corresponding label in the array.

Parameters:

value - The integer value whose bits are to be interpreted.

valueLabels - An array of strings representing the labels for each bit position.

Returns:

A string that represents the bit values mapped to the corresponding labels.

bitsValue

public static String bitsValue(int value,
 StringList valueLabels)

Converts the bits in the given integer value into a comma-separated string based on the corresponding labels in the provided list.

Parameters:

value - the integer whose bits are to be processed

valueLabels - the list of labels corresponding to the bit positions

Returns:

a comma-separated string representing the labels for the set bits in the integer value, in order of the bit positions

same

public static boolean same(CharSequence one,
 CharSequence two)

Compares two CharSequence objects for equality by checking if they have the same length and identical characters at each corresponding position.

Parameters:

one - the first CharSequence to compare

two - the second CharSequence to compare

Returns:

true if the two CharSequences are of the same length and have the same characters at each position, false otherwise

format

public static String format(double value)

Formats a double value as a numeric string. Up to 14 fractional digits will be considered. If you want the thousand separations, please use format(double, boolean).

Parameters:

value - Double value to be converted.

Returns:

Formatted value

format

public static String format(double value,
 boolean separated)

Formats a double value as a numeric string. Up to 14 fractional digits will be considered.

Parameters:

value - Double value to be converted.

separated - True if thousands of separations are needed in the output.

Returns:

Formatted value

formatIndian

public static String formatIndian(double value,
 boolean separated)

Formats a double value as a numeric string (Indian style). Up to 14 fractional digits will be considered.

Parameters:

value - Double value to be converted.

separated - True if thousands of separations are needed in the output.

Returns:

Formatted value

format

public static String format(double value,
 int decimals)

Formats a double value as a numeric string with a thousand separation.

Parameters:

value - Double value to be converted.

decimals - Number of decimals required in the output string. Passing -1 causes all non-zero decimals up to 14 positions to be incorporated.

Returns:

Formatted value

format

public static String format(double value,
 int decimals,
 boolean separated)

Formats a double value as a numeric string with a thousand separation.

Parameters:

value - Double value to be converted.

decimals - Number of decimals required in the output string. Passing -1 causes all non-zero decimals up to 14 positions to be incorporated.

separated - True if a thousand separation are needed in the output.

Returns:

Formatted value

formatIndian

public static String formatIndian(double value,
 int decimals,
 boolean separated)

Formats a double value as a numeric string with thousands separation (Indian style).

Parameters:

value - Double value to be converted.

decimals - Number of decimals required in the output string. Passing -1 causes all non-zero decimals up to 14 positions to be incorporated.

separated - True if a thousand separation is needed in the output.

Returns:

Formatted value

format

public static String format(String s,
 int decimals,
 boolean separated)

Formats a string as a numeric string with the thousand separations.

Parameters:

s - String of digits (can contain a decimal point).

decimals - Number of decimals required in the output string.

separated - True if a thousand separation is needed in the output.

Returns:

Formatted value

formatIndian

public static String formatIndian(String s,
 int decimals,
 boolean separated)

Formats a string as a numeric string with a thousand separation (Indian style).

Parameters:

s - String of digits (can contain a decimal point).

decimals - Number of decimals required in the output string.

separated - True if a thousand separation is needed in the output.

Returns:

Formatted value

words

public static String words(Number value)

Converts a numeric value into words. Decimal portion and negative part will be ignored

Parameters:

value - Value

Returns:

Value in words

words

public static String words(BigDecimal value)

Converts a numeric value into words. Decimal portion and negative part will be ignored

Parameters:

value - Value

Returns:

Value in words

words

public static String words(BigInteger value)

Converts a numeric value into words. Negative part will be ignored

Parameters:

value - Value

Returns:

Value in words

wordsIndian

public static String wordsIndian(BigDecimal value)

Converts a numeric value into words in Indian format. Decimal portion and negative part will be ignored

Parameters:

value - Value

Returns:

Value in words in Indian format

wordsIndian

public static String wordsIndian(BigInteger value)

Converts a numeric value into words in Indian format. Decimal portion and negative part will be ignored

Parameters:

value - Value

Returns:

Value in words in Indian format

equals

public static boolean equals(CharSequence one,
 CharSequence two)

See if 2 character sequences contain the same sequence of characters

Parameters:

one - First character sequence.

two - Second character sequence.

Returns:

True/False.

getTrace

public static String getTrace(Throwable error)

Retrieves a string representation of the stack trace for the provided throwable.

Parameters:

error - the throwable object whose stack trace is to be retrieved

Returns:

the string representation of the stack trace

getTrace

public static String getTrace(Thread thread)

Retrieves the stack trace of the specified thread as a string.

Parameters:

thread - the thread whose stack trace is to be retrieved

Returns:

a string representation of the stack trace for the given thread

toString

public static String toString(Object message)

Converts the provided object into its string representation. If the object implements the Displayable interface, its `toDisplay` method will be used to generate the string. Otherwise, a default string conversion is applied.

Parameters:

message - the object to be converted into a string representation

Returns:

the string representation of the provided object

toString

public static String toString(InputStream stream)
                       throws Exception

Converts the content of the given InputStream into a String.

Parameters:

stream - the InputStream to be converted; may be null.

Returns:

a String representation of the content of the InputStream, or null if the provided InputStream is null.

Throws:

Exception - if an error occurs while reading the InputStream.

toString

public static String toString(Reader reader)
                       throws Exception

Converts the content of a Reader into a String.

Parameters:

reader - the Reader containing the input to be converted; if null, the method will return null.

Returns:

a String representation of the content read from the provided Reader, or null if the input Reader is null.

Throws:

Exception - if there is an error while reading from the Reader.

getCSV

public static String[] getCSV(BufferedReader reader)
                       throws Exception

Reads a single line of CSV (Comma-Separated Values) data from a BufferedReader and parses it into an array of strings. Handles multi-line fields enclosed in quotes and line continuations where necessary.

Parameters:

reader - The BufferedReader to read input from. Must not be null.

Returns:

An array of strings containing the parsed CSV fields, or null if the input line is empty or null.

Throws:

Exception - If an error occurs during parsing or if a multi-line field is improperly terminated.

fill

public static String fill(String source,
 StringFiller filler)

Replace variables in the source string with values returned by the filler. Variables in the source string are of the form ${VariableName}. A sample source may look like "My name is ${name} and my age is ${age}". Here, 'name' and 'age' are the variables, and the values returned by filler.fill("name") and filler.fill("age") will be used to replace the variables in the string. So, the resulting string will look like "My name is Syam Pillai and my age is 40" if the return values are "Syam Pillai" and "40" respectively.

Parameters:

source - The source string.

filler - The filler logic.

Returns:

Result of substituting the variables in the source string with respective values returned by the filler logic.

collect

public static <T extends List<String>> T collect(T list,
 String[] items)

Adds the elements from the specified array to the given list.

Type Parameters:

T - the type of the list

Parameters:

list - the list to which elements should be added; must extend List of Strings

items - the array of strings to be added to the list

Returns:

the modified list containing the original elements and the new elements from the array

collect

public static <T extends List<String>> T collect(T list,
 StringList items)

Adds all elements from the specified StringList to the provided list and returns the updated list.

Type Parameters:

T - the type of the list

Parameters:

list - the list to which elements will be added

items - the StringList containing elements to add to the list

Returns:

the updated list containing the added elements

md5

public static String md5(String input)

MD5 encryption

Parameters:

input - Input string to encrypt

Returns:

Encrypted output in hex-coded form