de.saxsys.svgfx.core.utils

Class StringUtil

java.lang.Object

de.saxsys.svgfx.core.utils.StringUtil

public final class StringUtil
extends Object

This class provides functionality to handle Strings

Author:

by Xyanid on 28.10.2015.

Method Summary

Modifier and Type	Method and Description
static boolean	isNotNullOrEmpty(String data) Determines if the given String is not null or empty.
static boolean	isNotNullOrEmptyAfterTrim(String data) Determines if the given String is not null or empty even after bring trimmed.
static boolean	isNullOrEmpty(String data) Determines if the given String is null or empty.
static boolean	isNullOrEmptyAfterTrim(String data) Determines if the given String is null or empty even after bring trimmed.
static String	replaceLast(String source, char toReplace, char toUse) Replaces the last occurrence of a character in the given source.
static String	replaceLast(String source, String toReplace, String toUse) Replaces the last occurrence of a character in the given source.
static <E extends Exception> void	splitByDelimiters(String data, Collection<Character> delimiters, ThrowableBiConsumer<Character,String,E> splitConsumer) Parse the given data and split the string at every position that is a one of the provided delimiters.
static <E extends Exception> List<String>	splitByDelimiters(String data, Collection<Character> delimiters, ThrowablePredicate<String,E> consumePredicate) Creates a new List of Strings that contain the data, which was split by any of the given delimiters.
static String	stripStringIndicators(String data) Strips the " characters at the start and end of the given string if present.

Methods inherited from class java.lang.Object

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

Method Detail

replaceLast

public static String replaceLast(String source,
                                 char toReplace,
                                 char toUse)

Replaces the last occurrence of a character in the given source.

Parameters:

source - source which contains the data to be used

toReplace - the character that is to be replaced

toUse - the character that is used instead

Returns:

a new String where last occurrence of the given character is replaced by the provided character or the original string if its null or does not contain the character

replaceLast

public static String replaceLast(String source,
                                 String toReplace,
                                 String toUse)

Replaces the last occurrence of a character in the given source.

Parameters:

source - source which contains the data to be used

toReplace - the character that is to be replaced

toUse - the character that is used instead

Returns:

a new String where last occurrence of the given character is replaced by the provided character or the original string if its null or does not contain the character

isNullOrEmpty

public static boolean isNullOrEmpty(String data)

Determines if the given String is null or empty.

Parameters:

data - the String to check.

Returns:

true if the String is null or empty otherwise false.

isNotNullOrEmpty

public static boolean isNotNullOrEmpty(String data)

Determines if the given String is not null or empty.

Parameters:

data - the String to check.

Returns:

true if the String is not null or empty otherwise false.

isNullOrEmptyAfterTrim

public static boolean isNullOrEmptyAfterTrim(String data)

Determines if the given String is null or empty even after bring trimmed.

Parameters:

data - the String to check.

Returns:

true if the String is null or empty after trimmed otherwise false.

isNotNullOrEmptyAfterTrim

public static boolean isNotNullOrEmptyAfterTrim(String data)

Determines if the given String is not null or empty even after bring trimmed.

Parameters:

data - the String to check.

Returns:

true if the String is not null or empty after trimmed otherwise false.

stripStringIndicators

public static String stripStringIndicators(String data)

Strips the " characters at the start and end of the given string if present.

Parameters:

data - data to be used, must not be null or empty

Returns:

the data without " character at the start and end.

Throws:

IllegalArgumentException - if the given data is null or empty

splitByDelimiters

public static <E extends Exception> List<String> splitByDelimiters(String data,
                                                                   Collection<Character> delimiters,
                                                                   ThrowablePredicate<String,E> consumePredicate)
                                                            throws E extends Exception

Creates a new List of Strings that contain the data, which was split by any of the given delimiters. The delimiters are not part of the items in the list.

Type Parameters:

E - the type of exception to throw.

Parameters:

data - the data that needs to be split.

delimiters - the delimiters that indicate when the string needs to be split.

consumePredicate - the ThrowablePredicate to use, which will determine if the currently split value will be part of the result.

Returns:

a new List of Strings that contain the data, which was split by any of the given delimiters, delimiters are not present in the list.

Throws:

E - when an error occurs during the splitting.

E extends Exception

splitByDelimiters

public static <E extends Exception> void splitByDelimiters(String data,
                                                           Collection<Character> delimiters,
                                                           ThrowableBiConsumer<Character,String,E> splitConsumer)
                                                    throws E extends Exception

Parse the given data and split the string at every position that is a one of the provided delimiters. The data that has been read so far and the last know delimiter will be consumed by the ThrowableBiConsumer. Unless this function returns true, the data will be accumulated.

Imaging the following string with T and R being the sole delimiters. The following would happen:

Provided data	Consumption	Delimiter	Data
"T"	1.	"T"	null
"123"	1.	null	"123"
"T123"	1.	"T"	"123"
"T123R"	1.	"T"	"123"
	2.	"R"	null
"T123R567"	1.	"T"	"123"
	2.	"R"	"567"
"T123R567T"	1.	"T"	"123"
	2.	"R"	"567"
	3.	"T"	null

Type Parameters:

E - the type of exception to throw.

Parameters:

data - the data that needs to be split.

delimiters - the delimiters that indicate when the string needs to be split.

splitConsumer - the ThrowableBiConsumer which will consumeOrFail each split action.

Throws:

E - when an error occurs during the splitting.

E extends Exception