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

Constructor Summary

Constructors

Constructor	Description
StringUtility()

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)
static String	bitsValue(int value, String[] valueLabels)
static <T extends List<String>> T	collect(T list, StringList items)
static <T extends List<String>> T	collect(T list, String[] items)
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 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 proper case (first letter of each word will be capitalized).
static String[]	firstCaps(String[] a)	Convert each element of the string array to proper case (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 thousands separation.
static String	format(double value, int decimals, boolean separated)	Formats a double value as a numeric string with thousands separation.
static String	format(String s, int decimals, boolean separated)	Formats a string as a numeric string with thousands separation.
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 thousands 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)
static int	getStringCount(String text, String pattern)	Gets the number of occurrences of a given string in this string.
static String	getTrace(Thread thread)
static String	getTrace(Throwable error)
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 its ends with a modulus 11 check digit.
static boolean	isModulus11(String alphanumeric)	Check the alphanumeric string passed to see if its 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 label by inserting a space before each capital letter.
static String	makeLabel(String s, boolean lowerPropositions)	Make 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)
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)
static String	toString(Reader reader)
static String	toString(Object message)
static char[]	toUpperCase(char[] s)	Convert to upper case.
static String[]	toUpperCase(String[] s)	Convert to 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

public StringUtility()

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 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 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 proper case (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 proper case (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 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 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 operated 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 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 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 its 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 its 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 object is null or toString method generate errors 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 string array. If the input is null, output will also be null. Null elements in the source array will generate 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 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 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 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 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)

bitsValue

public static String bitsValue(int value,
 StringList valueLabels)

same

public static boolean same(CharSequence one,
 CharSequence two)

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 thousands separation, 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 separation is 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 separation is 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 thousands 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 thousands 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 thousands separation is 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 thousands 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 thousands separation.

Parameters:

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

decimals - Number of decimals required in the output string.

separated - True if thousands 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 thousands 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 thousands 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 same sequence of characters

Parameters:

one - First character sequence.

two - Second character sequence.

Returns:

True/False.

getTrace

public static String getTrace(Throwable error)

getTrace

public static String getTrace(Thread thread)

toString

public static String toString(Object message)

toString

public static String toString(InputStream stream)
                       throws Exception

Throws:

Exception

toString

public static String toString(Reader reader)
                       throws Exception

Throws:

Exception

getCSV

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

Throws:

Exception

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)

collect

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

md5

public static String md5(String input)

MD5 encryption

Parameters:

input - Input string to encrypt

Returns:

Encrypted output in hex-coded form