icy.util

Class StringUtil

java.lang.Object

icy.util.StringUtil

public class StringUtil
extends java.lang.Object

Author:

stephane

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StringUtil.AlphanumComparator This is an updated version of Alphanum Algorithm Comparator with enhancements made by Daniel Migowski, Andre Bogus, and David Koelle

Constructor Summary

Constructors

Constructor and Description
StringUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	containHtmlCR(java.lang.String text) Return true if the specified text contains HTML line break sequence.
static boolean	equals(java.lang.String s1, java.lang.String s2) Return true if the specified String are exactly the same
static boolean	equals(java.lang.String s1, java.lang.String s2, boolean trim) Return true if the specified String are exactly the same.
static java.lang.String	getFlattened(java.lang.String string) Creates a flattened version of the provided String.
static int	getNextCtrlCharIndex(java.lang.CharSequence value, int startIndex) Return the index of next control char from specified startIndex in specified string.
static int	getNextDigitCharIndex(java.lang.CharSequence value, int from) Return the index of next digit char from specified index in specified string return -1 if not found
static int	getNextLetterCharIndex(java.lang.CharSequence value, int from) Return the index of next letter char from specified index in specified string return -1 if not found
static int	getNextNonDigitCharIndex(java.lang.CharSequence value, int from) Return the index of next non digit char from specified index in specified string return -1 if not found
static int	getNextNonLetterCharIndex(java.lang.CharSequence value, int from) Return the index of next non letter char from specified index in specified string return -1 if not found
static java.lang.CharSequence	getNextNumber(java.lang.CharSequence text, int index) Returns the next number found from specified startIndex in specified string.
static int	getPreviousDigitCharIndex(java.lang.CharSequence value, int from) Return the index of previous digit char from specified index in specified string return -1 if not found
static int	getPreviousLetterCharIndex(java.lang.CharSequence value, int from) Return the index of previous letter char from specified index in specified string return -1 if not found
static int	getPreviousNonDigitCharIndex(java.lang.CharSequence value, int from) Return the index of previous non digit char from specified index in specified string return -1 if not found
static int	getPreviousNonLetterCharIndex(java.lang.CharSequence value, int from) Return the index of previous non letter char from specified index in specified string Return -1 if not found.
static java.lang.String	getValue(java.lang.String value, java.lang.String defaultValue) Return defaultValue if value is empty
static java.lang.String	htmlBoldSubstring(java.lang.String text, java.lang.String keyword, boolean ignoreCase) Bold (inserting HTML bold tag) the specified keyword in the text.
static boolean	isEmpty(java.lang.String value) Return true if the specified String is empty.
static boolean	isEmpty(java.lang.String value, boolean trim) Return true if the specified String is empty.
static java.lang.String	limit(java.lang.String value, int maxlen) Limit the length of the specified string to maxlen.
static java.lang.String	limit(java.lang.String value, int maxlen, boolean tailLimit) Limit the length of the specified string to maxlen.
static boolean	parseBoolean(java.lang.String s, boolean def) Try to parse a boolean from the specified String and return it.
static byte[]	parseBytes(java.lang.String s, byte[] def) Try to parse a array of byte from the specified String and return it.
static double	parseDouble(java.lang.String s, double def) Try to parse a double from the specified String and return it.
static float	parseFloat(java.lang.String s, float def) Try to parse a float from the specified String and return it.
static int	parseInt(java.lang.String s, int def) Try to parse a integer from the specified String and return it.
static long	parseLong(java.lang.String s, long def) Try to parse a long integer from the specified String and return it.
static java.lang.String	removeCR(java.lang.String text) Remove all C line break sequence : "\n", "\r", "\r\n" from the specified text.
static java.lang.String	removeLast(java.lang.String value, int count) Remove count characters from the end of specified string.
static java.lang.String	replaceCR(java.lang.String text, java.lang.String str) Replace all C line break sequence : "\n", "\r", "\r\n" from the specified text by str.
static java.util.List<java.lang.String>	split(java.lang.String text) Split a text into word based on space character while preserving quoted sentences.
static java.lang.String	toHexaString(int value) Returns a string representation of the integer argument as an unsigned integer in base 16.
static java.lang.String	toHexaString(int value, int size) Returns a string representation of the integer argument as an unsigned integer in base 16.
static java.lang.String	toHtmlCR(java.lang.String text) Convert the C line break sequence : "\n", "\r", "\r\n" to HTML line break sequence.
static java.lang.String	toString(boolean value) Returns a String object representing the specified boolean.
static java.lang.String	toString(byte[] value) Return a string representation of the byte array argument.
static java.lang.String	toString(double value) Returns a string representation of the double argument.
static java.lang.String	toString(double value, int numDecimal) Returns a string representation of the double argument with specified number of decimal.
static java.lang.String	toString(float value) Returns a string representation of the float argument.
static java.lang.String	toString(int value) Returns a String object representing the specified integer.
static java.lang.String	toString(int value, int minSize) Returns a String object representing the specified integer.
static java.lang.String	toString(long value) Returns a String object representing the specified long.
static java.lang.String	toStringEx(double value, int size) Returns a string representation of the double argument with specified size : toString(1.23456, 5) --> "1.2345" toString(123.4567, 4) --> "123.4" toString(1234.567, 2) --> "1234" as we never trunk integer part.
static java.lang.String	trunc(java.lang.String fullText, java.lang.String keyword, int maxSize) Truncate the text to a specific size, according a keyword.
static java.lang.String	wildcardToRegex(java.lang.String wildcard) Converts wildcard to regular expression.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringUtil

public StringUtil()

Method Detail

getValue

public static java.lang.String getValue(java.lang.String value,
                        java.lang.String defaultValue)

Return defaultValue if value is empty

getNextNumber

public static java.lang.CharSequence getNextNumber(java.lang.CharSequence text,
                                   int index)

Returns the next number found from specified startIndex in specified string.
Returns an empty string if no number was found.

getPreviousDigitCharIndex

public static int getPreviousDigitCharIndex(java.lang.CharSequence value,
                            int from)

Return the index of previous digit char from specified index in specified string
return -1 if not found

getPreviousLetterCharIndex

public static int getPreviousLetterCharIndex(java.lang.CharSequence value,
                             int from)

Return the index of previous letter char from specified index in specified string
return -1 if not found

getPreviousNonDigitCharIndex

public static int getPreviousNonDigitCharIndex(java.lang.CharSequence value,
                               int from)

Return the index of previous non digit char from specified index in specified string
return -1 if not found

getPreviousNonLetterCharIndex

public static int getPreviousNonLetterCharIndex(java.lang.CharSequence value,
                                int from)

Return the index of previous non letter char from specified index in specified string
Return -1 if not found.

getNextDigitCharIndex

public static int getNextDigitCharIndex(java.lang.CharSequence value,
                        int from)

Return the index of next digit char from specified index in specified string
return -1 if not found

getNextLetterCharIndex

public static int getNextLetterCharIndex(java.lang.CharSequence value,
                         int from)

Return the index of next letter char from specified index in specified string
return -1 if not found

getNextNonDigitCharIndex

public static int getNextNonDigitCharIndex(java.lang.CharSequence value,
                           int from)

Return the index of next non digit char from specified index in specified string
return -1 if not found

getNextNonLetterCharIndex

public static int getNextNonLetterCharIndex(java.lang.CharSequence value,
                            int from)

Return the index of next non letter char from specified index in specified string
return -1 if not found

getNextCtrlCharIndex

public static int getNextCtrlCharIndex(java.lang.CharSequence value,
                       int startIndex)

Return the index of next control char from specified startIndex in specified string.
return -1 if no control character found.

limit

public static java.lang.String limit(java.lang.String value,
                     int maxlen,
                     boolean tailLimit)

Limit the length of the specified string to maxlen.

limit

public static java.lang.String limit(java.lang.String value,
                     int maxlen)

Limit the length of the specified string to maxlen.

trunc

public static java.lang.String trunc(java.lang.String fullText,
                     java.lang.String keyword,
                     int maxSize)

Truncate the text to a specific size, according a keyword.
The text will be truncated around the place where the keyword is found.
If the string is found at the beginning, the text will be like this:
Lorem ipsum dolor sit amet, consec...

Parameters:

fullText - : text to be truncated.

keyword - : string to be found in the text and truncated around.

maxSize - : max size of the string

equals

public static boolean equals(java.lang.String s1,
             java.lang.String s2,
             boolean trim)

Return true if the specified String are exactly the same.

Parameters:

trim - if true then string are trimmed before comparison

equals

public static boolean equals(java.lang.String s1,
             java.lang.String s2)

Return true if the specified String are exactly the same

isEmpty

public static boolean isEmpty(java.lang.String value,
              boolean trim)

Return true if the specified String is empty.

Parameters:

trim - trim the String before doing the empty test

isEmpty

public static boolean isEmpty(java.lang.String value)

Return true if the specified String is empty. The String is trimed by default before doing the test

parseBoolean

public static boolean parseBoolean(java.lang.String s,
                   boolean def)

Try to parse a boolean from the specified String and return it. Return 'def' is we can't parse any boolean from the string.

parseInt

public static int parseInt(java.lang.String s,
           int def)

Try to parse a integer from the specified String and return it. Return 'def' is we can't parse any integer from the string.

parseLong

public static long parseLong(java.lang.String s,
             long def)

Try to parse a long integer from the specified String and return it. Return 'def' is we can't parse any integer from the string.

parseFloat

public static float parseFloat(java.lang.String s,
               float def)

Try to parse a float from the specified String and return it. Return 'def' is we can't parse any float from the string.

parseDouble

public static double parseDouble(java.lang.String s,
                 double def)

Try to parse a double from the specified String and return it. Return 'def' is we can't parse any double from the string.

parseBytes

public static byte[] parseBytes(java.lang.String s,
                byte[] def)

Try to parse a array of byte from the specified String and return it. Return 'def' is we can't parse any array of byte from the string.

toString

public static java.lang.String toString(boolean value)

Returns a String object representing the specified boolean. If the specified boolean is true, then the string "true" will be returned, otherwise the string "false" will be returned.

toString

public static java.lang.String toString(int value)

Returns a String object representing the specified integer.

toString

public static java.lang.String toString(int value,
                        int minSize)

Returns a String object representing the specified integer.
If the returned String is shorter than specified length
then leading '0' are added to the string.

toString

public static java.lang.String toString(long value)

Returns a String object representing the specified long.

toString

public static java.lang.String toString(float value)

Returns a string representation of the float argument.

toString

public static java.lang.String toString(double value)

Returns a string representation of the double argument.

toString

public static java.lang.String toString(double value,
                        int numDecimal)

Returns a string representation of the double argument with specified number of decimal.

toStringEx

public static java.lang.String toStringEx(double value,
                          int size)

Returns a string representation of the double argument with specified size :
toString(1.23456, 5) --> "1.2345"
toString(123.4567, 4) --> "123.4"
toString(1234.567, 2) --> "1234" as we never trunk integer part.
toString(1234.5, 10) --> "1234.5" as we never trunk integer part.

toString

public static java.lang.String toString(byte[] value)

Return a string representation of the byte array argument.

toHexaString

public static java.lang.String toHexaString(int value)

Returns a string representation of the integer argument as an unsigned integer in base 16.

toHexaString

public static java.lang.String toHexaString(int value,
                            int size)

Returns a string representation of the integer argument as an unsigned integer in base 16.
Force the returned string to have the specified size :
If the string is longer then only last past is kept.
If the string is shorter then leading 0 are added to the string.

removeLast

public static java.lang.String removeLast(java.lang.String value,
                          int count)

Remove count characters from the end of specified string.

getFlattened

public static java.lang.String getFlattened(java.lang.String string)

Creates a flattened version of the provided String. The flattening operation splits the string by inserting spaces between words starting with an upper case letter, and converts upper case letters to lower case (with the exception of the first word). Note that consecutive upper case letters will remain grouped, as they are considered to represent an acronym.

NOTE: This method is optimized for class names that follow the Java naming convention.
Examples:
MyGreatClass -> "My great class"
MyXYZClass -> "My XYZ class"

Parameters:

string - the string to flatten

Returns:

a flattened (i.e. pretty-printed) String based on the name of the string

replaceCR

public static java.lang.String replaceCR(java.lang.String text,
                         java.lang.String str)

Replace all C line break sequence : "\n", "\r", "\r\n"
from the specified text by str.

removeCR

public static java.lang.String removeCR(java.lang.String text)

Remove all C line break sequence : "\n", "\r", "\r\n"
from the specified text.

toHtmlCR

public static java.lang.String toHtmlCR(java.lang.String text)

Convert the C line break sequence : "\n", "\r", "\r\n"
to HTML line break sequence.

containHtmlCR

public static boolean containHtmlCR(java.lang.String text)

Return true if the specified text contains HTML line break sequence.

htmlBoldSubstring

public static java.lang.String htmlBoldSubstring(java.lang.String text,
                                 java.lang.String keyword,
                                 boolean ignoreCase)

Bold (inserting HTML bold tag) the specified keyword in the text.

split

public static java.util.List<java.lang.String> split(java.lang.String text)

Split a text into word based on space character while preserving quoted sentences.

Parameters:

text - text to split into word.
Example:
this book is named "the red cat" -->

this

book

is

named

the red cat

Returns:

String array representing words

wildcardToRegex

public static java.lang.String wildcardToRegex(java.lang.String wildcard)

Converts wildcard to regular expression.

Parameters:

wildcard -

Returns:

regex