StringUtility (AOCode Public 1.8.2 API)

java.lang.Object
- com.aoindustries.util.StringUtility

public final class StringUtility
extends Object

Author:: AO Industries, Inc.

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static String`	`buildEmailList(String[] list)` Deprecated. This method is no longer used and will be removed.
`static String`	`buildList(Iterable<?> objects)` Deprecated. Please use `join(objects, ", ")` instead.
`static String`	`buildList(Object[] objects)` Deprecated. Please use `join(objects, ", ")` instead.
`static String`	`buildList(String[] list)` Deprecated. Please use `join(objects, ", ")` instead.
`static int`	`compareToDDMMYYYY(String date1, String date2)` Compare one date to another, must be in the DDMMYYYY format.
`static int`	`compareToIgnoreCaseCarefulEquals(String S1, String S2)` Compares two strings in a case insensitive manner.
`static boolean`	`containsIgnoreCase(String line, String word)`
`static byte[]`	`convertByteArrayFromHex(char[] hex)`
`static int`	`convertIntArrayFromHex(char[] hex)`
`static long`	`convertLongArrayFromHex(char[] hex)`
`static long`	`convertStringDateToTime(String date)`
`static String`	`convertToHex(byte[] bytes)`
`static void`	`convertToHex(byte[] bytes, Appendable out)`
`static String`	`convertToHex(int value)` Converts an int to a full 8-character hex code.
`static void`	`convertToHex(int value, Appendable out)` Converts an int to a full 8-character hex code.
`static String`	`convertToHex(long value)` Converts a long integer to a full 16-character hex code.
`static void`	`convertToHex(long value, Appendable out)` Converts a long integer to a full 16-character hex code.
`static int`	`countOccurances(byte[] buff, int len, String word)` Deprecated. Corrected spelling
`static int`	`countOccurances(byte[] buff, String word)` Deprecated. Corrected spelling
`static int`	`countOccurances(String line, String word)` Deprecated. Corrected spelling
`static int`	`countOccurrences(byte[] buff, int len, String word)` Counts how many times a word appears in a line.
`static int`	`countOccurrences(byte[] buff, String word)` Counts how many times a word appears in a line.
`static int`	`countOccurrences(String line, String word)` Counts how many times a word appears in a line.
`static String`	`escapeSQL(String s)` Deprecated. Please use SQLUtility.escapeSQL(s.replace('*', '%'))
`static String`	`firstLineOnly(String value, int maxCharacters)` Returns the first line only, and only up to the maximum number of characters.
`static String`	`getApproximateBitRate(long bit_rate)` Gets the approximate bit rate (where k=1000) in this format: x xx xxx x.x k xx.x k xxx k x.x M xx.x M xxx M x.x G xx.x G xxx G x.x T xx.x T xxx T xxx...
`static String`	`getApproximateSize(long size)` Gets the approximate size (where k=1024) of a file in this format: x byte(s) xx bytes xxx bytes x.x k xx.x k xxx k x.x M xx.x M xxx M x.x G xx.x G xxx G x.x T xx.x T xxx T xxx...
`static Date`	`getDateMMDDYYYY(String date)` Converts a date in a the format MMDDYYYY to a `Date`.
`static String`	`getDateString(Date date)` Deprecated. Please use SQLUtility.getDate(date.getTime())
`static String`	`getDateString(long time)` Deprecated. Please use SQLUtility.getDate(long)
`static String`	`getDateStringMMDDYYYY(Date date)` Deprecated. Please use SQLUtility.getDate(date.getTime())
`static String`	`getDateStringSecond(long time)` Deprecated. Please use SQLUtility.getDateTime(long)
`static String`	`getDateStringSecond(String time)` Deprecated. Please use SQLUtility.getDateTime(long)
`static String`	`getDecimalTimeLengthString(long time)`
`static String`	`getDecimalTimeLengthString(long time, boolean alwaysShowMillis)`
`static int`	`getHex(char ch)` Converts one hex digit to an integer
`static char`	`getHexChar(int v)` Gets the hexadecimal character for the low-order four bits of the provided int.
`static String`	`getMonth(int month)` Deprecated. This method is not locale-aware, is no longer used, and will be removed.
`static String[]`	`getStringArray(List<?> V)` Deprecated. Please use List.toArray(Object[])
`static String`	`getTimeLengthString(long time)`
`static int`	`indexOf(String S, char[] chars)` Finds the first occurrence of any of the supplied characters
`static int`	`indexOf(String S, char[] chars, int start)` Finds the first occurrence of any of the supplied characters starting at the specified index.
`static int`	`indexOf(String source, String target, int fromIndex, int toIndex)` Finds the next of a substring like regular String.indexOf, but stops at a certain maximum index.
`static String`	`intern(String S)` Deprecated. Use InternUtils instead.
`static boolean`	`isValidDate(String date)` Deprecated. Please use Calendar class instead.
`static String`	`join(Iterable<?> objects, String delimiter)` Joins the string representation of objects on the provided delimiter.
`static String`	`join(Object[] objects, String delimiter)` Joins the string representation of objects on the provided delimiter.
`static boolean`	`leapYear(int year)` Deprecated. Please use Calendar class instead.
`static String`	`nullIfEmpty(String value)` Returns null if the string is null or empty.
`static String`	`removeChars(String S, char ch)` Deprecated. this method is slow and no longer supported
`static String`	`removeChars(String S, char[] chars)` Deprecated. this method is slow and no longer supported
`static void`	`replace(StringBuffer sb, String find, String replacement)` Replaces all occurrences of a String with a String.
`static void`	`replace(StringBuilder sb, String find, String replacement)` Replaces all occurrences of a String with a String.
`static String`	`replace(String string, char ch, String replacement)` Replaces all occurrences of a character with a String
`static String`	`replace(String string, String find, String replacement)` Replaces all occurrences of a String with a String Please consider the variant with the Appendable for higher performance.
`static void`	`replace(String string, String find, String replacement, Appendable out)` Replaces all occurrences of a String with a String, appends the replacement to `out`.
`static List<String>`	`splitLines(String S)` Splits a String into lines on any '\n' characters.
`static String[]`	`splitString(String line)` Splits a `String` into a `String[]`.
`static List<String>`	`splitString(String line, char delim)` Splits a string on the given delimiter.
`static int`	`splitString(String line, char[][][] buff)` Splits a `String` into a `String[]`.
`static <C extends Collection<String>> C`	`splitString(String line, char delim, C words)` Splits a string on the given delimiter.
`static List<String>`	`splitString(String line, int begin, int end, char delim)` Splits a string on the given delimiter over the given range.
`static <C extends Collection<String>> C`	`splitString(String line, int begin, int end, char delim, C words)` Splits a string on the given delimiter over the given range.
`static List<String>`	`splitString(String line, String delim)`
`static int`	`splitString(String line, String[][] buff)` Splits a `String` into a `String[]`.
`static List<String>`	`splitStringCommaSpace(String line)` Splits a string into multiple words on either whitespace or commas
`static String`	`wordWrap(String string, int width)` Deprecated. Use new version with Appendable for higher performance
`static void`	`wordWrap(String string, int width, Appendable out)` Word wraps a `String` to be no longer than the provided number of characters wide.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getMonth
```
@Deprecated
public static String getMonth(int month)
```
Deprecated. This method is not locale-aware, is no longer used, and will be removed.

buildEmailList
```
@Deprecated
public static String buildEmailList(String[] list)
```
Deprecated. This method is no longer used and will be removed.

Constructs a comma separated list from a String[].

buildList
```
@Deprecated
public static String buildList(String[] list)
```
Deprecated. Please use join(objects, ", ") instead.

Constructs a comma separated list from a String[].

See Also:

join(java.lang.Object[], java.lang.String)

buildList
```
@Deprecated
public static String buildList(Object[] objects)
```
Deprecated. Please use join(objects, ", ") instead.

Constructs a comma separated list from an Object[].

See Also:

join(java.lang.Object[], java.lang.String)

buildList
```
@Deprecated
public static String buildList(Iterable<?> objects)
```
Deprecated. Please use join(objects, ", ") instead.

Constructs a comma separated list from an Iterable.

See Also:

join(java.lang.Iterable, java.lang.String)

join
```
public static String join(Iterable<?> objects,
                          String delimiter)
                   throws ConcurrentModificationException
```
Joins the string representation of objects on the provided delimiter. The iteration will be performed twice. Once to compute the total length of the resulting string, and the second to build the result.

Throws:

ConcurrentModificationException - if iteration is not consistent between passes

join
```
public static String join(Object[] objects,
                          String delimiter)
                   throws ConcurrentModificationException
```
Joins the string representation of objects on the provided delimiter. The iteration will be performed twice. Once to compute the total length of the resulting string, and the second to build the result.

Throws:

ConcurrentModificationException - if iteration is not consistent between passes

compareToDDMMYYYY
```
public static int compareToDDMMYYYY(String date1,
                                    String date2)
```
Compare one date to another, must be in the DDMMYYYY format.

Returns:

<0 if the first date is before the second
0 if the dates are the same or the format is invalid
>0 if the first date is after the second

containsIgnoreCase

public static boolean containsIgnoreCase(String line,
                                         String word)

convertStringDateToTime

public static long convertStringDateToTime(String date)
                                    throws IllegalArgumentException

Throws:: IllegalArgumentException