uk.ac.ed.ph.snuggletex.internal.util

类 StringUtilities

java.lang.Object

uk.ac.ed.ph.snuggletex.internal.util.StringUtilities

public final class StringUtilities
extends java.lang.Object

Some vaguely useful String-related methods that are used from time to time.

(This is a cut-down version of the same class in ph-commons-util.)

字段概要

字段

限定符和类型	字段和说明
static java.lang.String[]	EMPTY_STRING_ARRAY Shared instance of an empty array of Strings, which is sometimes useful!

构造器概要

构造器

构造器和说明
StringUtilities()

方法概要

限定符和类型	方法和说明
static java.lang.String	emptyIfNull(java.lang.String string) Convenience method that turns a String to an empty String ("") if it is null.
static boolean	fromBinaryValues(java.lang.String value, java.lang.String trueValue, java.lang.String falseValue) Converts the given String argument to a boolean using the scheme trueValue => true, falseValue => false.
static boolean	fromTrueFalse(java.lang.String value) Converts the given String argument to a boolean using the scheme "true"=>true, "false"=>false.
static boolean	fromYesNo(java.lang.String value) Converts the given String argument to a boolean using the scheme "yes"=>true, "no"=>false.
static boolean	isNullOrEmpty(java.lang.String string) Tests whether the given String is null or empty ("").
static java.lang.String	join(java.lang.Iterable<? extends java.lang.Object> objects, java.lang.CharSequence separator) Joins the given collection of Objects using the given separator and each Object's normal toString() method.
static java.lang.String	join(java.lang.Object[] objects, java.lang.CharSequence separator) Same as join(Iterable, CharSequence) but simply takes an array of Objects.
static java.lang.String	join(java.lang.Object[] objects, java.lang.CharSequence separator, int startIndex, int endIndex) Version of join(Object[], CharSequence) that allows you to specify a range of indices in the array to join.
static void	join(java.lang.StringBuilder resultBuilder, java.lang.Object[] objects, java.lang.CharSequence separator) Version of join(Object[], CharSequence) that allows you to pass in a StringBuilder that the result will be built up in.
static void	join(java.lang.StringBuilder resultBuilder, java.lang.Object[] objects, java.lang.CharSequence separator, int startIndex, int endIndex) Version of join(Object[], CharSequence, int, int) that allows you to pass in a StringBuilder that the result will be built up in.
static java.lang.String	nullIfEmpty(java.lang.String string) Convenience method that turns a String to null if it is empty (i.e. "") or null.
static java.lang.String	toTrueFalse(boolean state) Trivial helper method to convert a boolean into either "true" or "false" depending on its state.
static java.lang.String	toYesNo(boolean state) Trivial helper method to convert a boolean into either "yes" or "no" depending on its state.

从类继承的方法 java.lang.Object

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

字段详细资料

EMPTY_STRING_ARRAY

public static final java.lang.String[] EMPTY_STRING_ARRAY

Shared instance of an empty array of Strings, which is sometimes useful!

构造器详细资料

StringUtilities

public StringUtilities()

方法详细资料

join

public static java.lang.String join(java.lang.Iterable<? extends java.lang.Object> objects,
                                    java.lang.CharSequence separator)

Joins the given collection of Objects using the given separator and each Object's normal toString() method.

For example, joining the collection "a", "b", "c" with "/" gives "a/b/c".

参数:

objects - collection of Objects to join

separator - separator to use

返回:

objects joined using the given separator.

join

public static java.lang.String join(java.lang.Object[] objects,
                                    java.lang.CharSequence separator)

Same as join(Iterable, CharSequence) but simply takes an array of Objects.

参数:

objects - array of Objects to join

separator - separator to use

join

public static void join(java.lang.StringBuilder resultBuilder,
                        java.lang.Object[] objects,
                        java.lang.CharSequence separator)

Version of join(Object[], CharSequence) that allows you to pass in a StringBuilder that the result will be built up in. This is useful if you need to do add in other stuff later on.

参数:

resultBuilder - StringBuilder to append results to

objects - array of Objects to join

separator - separator to use

join

public static java.lang.String join(java.lang.Object[] objects,
                                    java.lang.CharSequence separator,
                                    int startIndex,
                                    int endIndex)

Version of join(Object[], CharSequence) that allows you to specify a range of indices in the array to join. This can be useful in some cases.

参数:

objects - array of Objects to join

separator - separator to use

startIndex - first index to join

endIndex - index after last one to join

join

public static void join(java.lang.StringBuilder resultBuilder,
                        java.lang.Object[] objects,
                        java.lang.CharSequence separator,
                        int startIndex,
                        int endIndex)

Version of join(Object[], CharSequence, int, int) that allows you to pass in a StringBuilder that the result will be built up in. This is useful if you need to do add in other stuff later on.

参数:

resultBuilder - StringBuilder to append results to

objects - array of Objects to join

separator - separator to use

startIndex - first index to join

endIndex - index after last one to join

isNullOrEmpty

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

Tests whether the given String is null or empty ("").

nullIfEmpty

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

Convenience method that turns a String to null if it is empty (i.e. "") or null.

参数:

string -

返回:

same string if it is non-null and non-empty, otherwise null.

emptyIfNull

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

Convenience method that turns a String to an empty String ("") if it is null.

参数:

string -

返回:

same string if it is non-empty, otherwise null.

toYesNo

public static java.lang.String toYesNo(boolean state)

Trivial helper method to convert a boolean into either "yes" or "no" depending on its state.

参数:

state - boolean to convert

返回:

"yes" if true, "no" if false.

toTrueFalse

public static java.lang.String toTrueFalse(boolean state)

Trivial helper method to convert a boolean into either "true" or "false" depending on its state.

参数:

state - boolean to convert

返回:

"true" if true, "false" if false.

fromYesNo

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

Converts the given String argument to a boolean using the scheme "yes"=>true, "no"=>false. Any other value results in an IllegalArgumentException.

参数:

value -

返回:

true if "yes", false if "no"

抛出:

java.lang.IllegalArgumentException - if value if null or neither "yes" or "no"

fromTrueFalse

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

Converts the given String argument to a boolean using the scheme "true"=>true, "false"=>false. Any other value results in an IllegalArgumentException.

参数:

value -

返回:

true if "yes", false if "no"

抛出:

java.lang.IllegalArgumentException - if value if null or neither "yes" or "no"

fromBinaryValues

public static boolean fromBinaryValues(java.lang.String value,
                                       java.lang.String trueValue,
                                       java.lang.String falseValue)

Converts the given String argument to a boolean using the scheme trueValue => true, falseValue => false. Any other value results in an IllegalArgumentException.

参数:

value -

trueValue - value returning true

falseValue - value returning false

抛出:

java.lang.IllegalArgumentException - if value if null or neither trueValue nor falseValue