Package org.sellcom.core

Class Strings

java.lang.Object

org.sellcom.core.Strings

public class Strings
extends java.lang.Object

Operations with strings.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
static java.lang.String	center(java.lang.String string, int targetLength, char padding)	Centers the given string within the given target length using the given padding.
static java.lang.String	commonPrefix(java.lang.String first, java.lang.String... other)	Returns the common prefix of the given strings.
static java.lang.String	commonSuffix(java.lang.String first, java.lang.String... other)	Returns the common suffix of the given strings.
static java.lang.String	emptyToNull(java.lang.String string)	Returns the given string if it is non-empty, null otherwise.
static boolean	endsWith(java.lang.String string, java.lang.String suffix, boolean ignoreCase)	Checks whether the given string ends with the given suffix, possibly ignoring case.
static java.lang.String	ensurePrefix(java.lang.String string, java.lang.String prefix)	Ensures that the given string starts with the given prefix.
static java.lang.String	ensurePrefix(java.lang.String string, java.lang.String prefix, boolean ignoreCase)	Ensures that the given string starts with the given prefix, possibly ignoring case.
static java.lang.String	ensureSuffix(java.lang.String string, java.lang.String suffix)	Ensures that the given string ends with the given suffix.
static java.lang.String	ensureSuffix(java.lang.String string, java.lang.String suffix, boolean ignoreCase)	Ensures that the given string ends with the given suffix, possibly ignoring case.
static java.lang.String	interleavePadding(java.lang.String string, java.lang.String padding)	Inserts the given padding between the characters of the given string.
static boolean	isBlank(java.lang.String string)	Checks whether the given string is composed from whitespace characters only.
static boolean	isNullOrEmpty(java.lang.String string)	Checks whether the given string is null or empty.
static java.lang.String	normalizeWhitespace(java.lang.String string)	Removes any leading and trailing whitespace characters from the given string and replaces any contained sequences of whitespace characters by a single space.
static java.lang.String	nullToEmpty(java.lang.String string)	Returns the given string if it is non-empty, an empty string otherwise.
static java.lang.String	padEnd(java.lang.String string, int minLength, char padding)	Appends the given padding to the given string to ensure its given minimum length.
static java.lang.String	padStart(java.lang.String string, int minLength, char padding)	Prepends the given padding to the given string to ensure its given minimum length.
static java.lang.String	removePrefix(java.lang.String string, java.lang.String prefix)	Removes the given prefix from the given string if present.
static java.lang.String	removePrefix(java.lang.String string, java.lang.String prefix, boolean ignoreCase)	Removes the given prefix from the given string if present, possibly ignoring case.
static java.lang.String	removeSuffix(java.lang.String string, java.lang.String suffix)	Removes the given suffix from the given string if present.
static java.lang.String	removeSuffix(java.lang.String string, java.lang.String suffix, boolean ignoreCase)	Removes the given suffix from the given string if present, possibly ignoring case.
static java.lang.String	removeWhitespace(java.lang.String string)	Removes all whitespace characters from the given string.
static java.lang.String	repeat(java.lang.String string, int count)	Returns a string consisting of the given number of copies of the given string.
static boolean	startsWith(java.lang.String string, java.lang.String prefix, boolean ignoreCase)	Checks whether the given string starts with the given prefix, possibly ignoring case.
static java.lang.String	toLowerCase(java.lang.String string)	Returns the given string converted to lower case in a locale-insensitive way.
static java.lang.String	toUpperCase(java.lang.String string)	Returns the given string converted to upper case in a locale-insensitive way.

Methods inherited from class java.lang.Object

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

Method Detail

center

public static java.lang.String center(java.lang.String string,
                                      int targetLength,
                                      char padding)

Centers the given string within the given target length using the given padding.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if targetLength is negative

Since:

1.4

commonPrefix

public static java.lang.String commonPrefix(java.lang.String first,
                                            java.lang.String... other)

Returns the common prefix of the given strings.

Throws:

java.lang.IllegalArgumentException - if first is null

java.lang.IllegalArgumentException - if other contain null

Since:

1.4

commonSuffix

public static java.lang.String commonSuffix(java.lang.String first,
                                            java.lang.String... other)

Returns the common suffix of the given strings.

Throws:

java.lang.IllegalArgumentException - if first is null

java.lang.IllegalArgumentException - if other contain null

Since:

1.4

emptyToNull

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

Returns the given string if it is non-empty, null otherwise.

Since:

1.0

endsWith

public static boolean endsWith(java.lang.String string,
                               java.lang.String suffix,
                               boolean ignoreCase)

Checks whether the given string ends with the given suffix, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if suffix is null

Since:

1.0

ensurePrefix

public static java.lang.String ensurePrefix(java.lang.String string,
                                            java.lang.String prefix)

Ensures that the given string starts with the given prefix.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if prefix is null

Since:

1.0

ensurePrefix

public static java.lang.String ensurePrefix(java.lang.String string,
                                            java.lang.String prefix,
                                            boolean ignoreCase)

Ensures that the given string starts with the given prefix, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if prefix is null

Since:

1.0

ensureSuffix

public static java.lang.String ensureSuffix(java.lang.String string,
                                            java.lang.String suffix)

Ensures that the given string ends with the given suffix.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if suffix is null

Since:

1.0

ensureSuffix

public static java.lang.String ensureSuffix(java.lang.String string,
                                            java.lang.String suffix,
                                            boolean ignoreCase)

Ensures that the given string ends with the given suffix, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if suffix is null

Since:

1.0

interleavePadding

public static java.lang.String interleavePadding(java.lang.String string,
                                                 java.lang.String padding)

Inserts the given padding between the characters of the given string.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if padding is null

Since:

1.4

isBlank

public static boolean isBlank(java.lang.String string)

Checks whether the given string is composed from whitespace characters only.

Since:

1.6

See Also:

Character.isWhitespace(int)

isNullOrEmpty

public static boolean isNullOrEmpty(java.lang.String string)

Checks whether the given string is null or empty.

Since:

1.0

normalizeWhitespace

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

Removes any leading and trailing whitespace characters from the given string and replaces any contained sequences of whitespace characters by a single space.

Throws:

java.lang.IllegalArgumentException - if string is null

Since:

1.0

nullToEmpty

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

Returns the given string if it is non-empty, an empty string otherwise.

Since:

1.0

padEnd

public static java.lang.String padEnd(java.lang.String string,
                                      int minLength,
                                      char padding)

Appends the given padding to the given string to ensure its given minimum length.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if minLength is negative

Since:

1.4

padStart

public static java.lang.String padStart(java.lang.String string,
                                        int minLength,
                                        char padding)

Prepends the given padding to the given string to ensure its given minimum length.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if minLength is negative

Since:

1.4

removePrefix

public static java.lang.String removePrefix(java.lang.String string,
                                            java.lang.String prefix)

Removes the given prefix from the given string if present.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if prefix is null

Since:

1.0

removePrefix

public static java.lang.String removePrefix(java.lang.String string,
                                            java.lang.String prefix,
                                            boolean ignoreCase)

Removes the given prefix from the given string if present, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if prefix is null

Since:

1.0

removeSuffix

public static java.lang.String removeSuffix(java.lang.String string,
                                            java.lang.String suffix)

Removes the given suffix from the given string if present.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if suffix is null

Since:

1.0

removeSuffix

public static java.lang.String removeSuffix(java.lang.String string,
                                            java.lang.String suffix,
                                            boolean ignoreCase)

Removes the given suffix from the given string if present, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if suffix is null

Since:

1.0

removeWhitespace

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

Removes all whitespace characters from the given string.

Throws:

java.lang.IllegalArgumentException - if string is null

Since:

1.0

repeat

public static java.lang.String repeat(java.lang.String string,
                                      int count)

Returns a string consisting of the given number of copies of the given string.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if count is negative

Since:

1.4

startsWith

public static boolean startsWith(java.lang.String string,
                                 java.lang.String prefix,
                                 boolean ignoreCase)

Checks whether the given string starts with the given prefix, possibly ignoring case.

Throws:

java.lang.IllegalArgumentException - if string is null

java.lang.IllegalArgumentException - if prefix is null

Since:

1.0

toLowerCase

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

Returns the given string converted to lower case in a locale-insensitive way.

Throws:

java.lang.IllegalArgumentException - if string is null

Since:

1.0

toUpperCase

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

Returns the given string converted to upper case in a locale-insensitive way.

Throws:

java.lang.IllegalArgumentException - if string is null

Since:

1.0