de.carne.util

Class Strings

java.lang.Object

de.carne.util.Strings

public final class Strings
extends java.lang.Object

Utility class providing String related functions.

Method Summary

Modifier and Type	Method and Description
static boolean	isEmpty(java.lang.String s) Check whether a String is empty.
static <T> java.lang.String	join(java.lang.Iterable<T> objects, java.util.function.Function<T,java.lang.String> converter, java.lang.String delimiter, int limit) Join a collection of strings.
static <T> java.lang.String	join(java.lang.Iterable<T> objects, java.lang.String delimiter) Join a collection of strings.
static <T> java.lang.String	join(java.lang.Iterable<T> objects, java.lang.String delimiter, int limit) Join a collection of strings.
static boolean	notEmpty(java.lang.String s) Check whether a String is not empty.
static java.lang.String	safe(java.lang.String s) Make sure a String is not null.
static java.lang.String	safeTrim(java.lang.String s) Make sure a String is trimmed.
static java.lang.String[]	split(java.lang.String s, java.lang.String delimiter) Split a String into multiple sub strings.

Methods inherited from class java.lang.Object

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

Method Detail

isEmpty

public static boolean isEmpty(@Nullable
                              java.lang.String s)

Check whether a String is empty.

A String is considered empty if it is either null of of length 0.

Parameters:

s - The string to check.

Returns:

true if the string is empty.

notEmpty

public static boolean notEmpty(@Nullable
                               java.lang.String s)

Check whether a String is not empty.

A String is considered empty if it is either null of of length 0.

Parameters:

s - The string to check.

Returns:

true if the string is not empty.

safe

public static java.lang.String safe(@Nullable
                                    java.lang.String s)

Make sure a String is not null.

The empty string is returned if a null value is submitted.

Parameters:

s - The string to check.

Returns:

The submitted string or the empty string if null was submitted.

safeTrim

@Nullable
public static java.lang.String safeTrim(@Nullable
                                                  java.lang.String s)

Make sure a String is trimmed.

If the string is null this function simply returns the submitted value.

Parameters:

s - The string to trim.

Returns:

The trimmed string, or null if null was submitted.

split

public static java.lang.String[] split(java.lang.String s,
                                       java.lang.String delimiter)

Split a String into multiple sub strings.

Parameters:

s - The string to split.

delimiter - The single character string to use as a delimiter.

Returns:

The split string.

join

public static <T> java.lang.String join(java.lang.Iterable<T> objects,
                                        java.lang.String delimiter)

Join a collection of strings.

Type Parameters:

T - The object type to join.

Parameters:

objects - The objects to join.

delimiter - The delimiter to use.

Returns:

The joined string.

join

public static <T> java.lang.String join(java.lang.Iterable<T> objects,
                                        java.lang.String delimiter,
                                        int limit)

Join a collection of strings.

Type Parameters:

T - The object type to join.

Parameters:

objects - The objects to join.

delimiter - The delimiter to use.

limit - The length after which the output will be truncated.

Returns:

The joined string.

join

public static <T> java.lang.String join(java.lang.Iterable<T> objects,
                                        java.util.function.Function<T,java.lang.String> converter,
                                        java.lang.String delimiter,
                                        int limit)

Join a collection of strings.

Type Parameters:

T - The object type to join.

Parameters:

objects - The objects to join.

converter - The converter to use for object to string conversion.

delimiter - The delimiter to use.

limit - The length after which the output will be truncated.

Returns:

The joined string.