org.assertj.core.util

Class Strings

java.lang.Object

org.assertj.core.util.Strings

public final class Strings
extends Object

Utility methods related to Strings.

Author:

Alex Ruiz

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Strings.StringsToJoin Knows how to join Strings using a given delimiter.
static class	Strings.StringToAppend Knows how to append a given String to the given target, only if the target does not end with the given String to append.

Method Summary

Modifier and Type	Method and Description
static Strings.StringToAppend	append(String toAppend) Appends a given String to the given target, only if the target does not end with the given String to append.
static String	concat(Object... objects) Concatenates the given objects into a single String.
static String	escapePercent(String value) Escape any % to %% to avoid interpreting it in String.format(String, Object...).
static String	formatIfArgs(String message, Object... args) Format with String.format(String, Object...) the given message iif some args have been given otherwise juts return the message.
static boolean	isNullOrEmpty(String s) Indicates whether the given String is null or empty.
static Strings.StringsToJoin	join(Iterable<?> toStringable) Joins the given Objects using a given delimiter.
static Strings.StringsToJoin	join(String... strings) Joins the given Strings using a given delimiter.
static Object	quote(Object o) Returns the given object surrounded by single quotes, only if the object is a String.
static String	quote(String s) Returns the given String surrounded by single quotes, or null if the given String is null.

Methods inherited from class java.lang.Object

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

Method Detail

isNullOrEmpty

public static boolean isNullOrEmpty(String s)

Indicates whether the given String is null or empty.

Parameters:

s - the String to check.

Returns:

true if the given String is null or empty, otherwise false.

quote

public static String quote(String s)

Returns the given String surrounded by single quotes, or null if the given String is null.

Parameters:

s - the given String.

Returns:

the given String surrounded by single quotes, or null if the given String is null.

quote

public static Object quote(Object o)

Returns the given object surrounded by single quotes, only if the object is a String.

Parameters:

o - the given object.

Returns:

the given object surrounded by single quotes, only if the object is a String.

See Also:

quote(String)

concat

public static String concat(Object... objects)

Concatenates the given objects into a single String. This method is more efficient than concatenating using "+", since only one StringBuilder is created.

Parameters:

objects - the objects to concatenate.

Returns:

a String containing the given objects.

formatIfArgs

public static String formatIfArgs(String message,
                                  Object... args)

Format with String.format(String, Object...) the given message iif some args have been given otherwise juts return the message.

Parameters:

message - the string to format

args - args used to format the message, can be null or empty

Returns:

the formatted string if any args were given

escapePercent

public static String escapePercent(String value)

Escape any % to %% to avoid interpreting it in String.format(String, Object...).

Parameters:

value - the String to escape

Returns:

the escaped String

join

public static Strings.StringsToJoin join(String... strings)

Joins the given Strings using a given delimiter. The following example illustrates proper usage of this method:

 Strings.join("a", "b", "c").with("|");

which will result in the String "a|b|c".

Parameters:

strings - the Strings to join.

Returns:

an intermediate object that takes a given delimiter and knows how to join the given Strings.

See Also:

Strings.StringsToJoin.with(String)

join

public static Strings.StringsToJoin join(Iterable<?> toStringable)

Joins the given Objects using a given delimiter. The following example illustrates proper usage of this method:

 Strings.join(new ArrayList("a", "b", "c")).with("|");

which will result in the String "a|b|c".

Parameters:

toStringable - the Objects to join.

Returns:

an intermediate object that takes a given delimiter and knows how to join the given Objects.

See Also:

Strings.StringsToJoin.with(String)

append

public static Strings.StringToAppend append(String toAppend)

Appends a given String to the given target, only if the target does not end with the given String to append. The following example illustrates proper usage of this method:

 Strings.append("c").to("ab");
 Strings.append("c").to("abc");

resulting in the String "abc" for both cases.

Parameters:

toAppend - the String to append.

Returns:

an intermediate object that takes the target String and knows to append the given String.

See Also:

Strings.StringToAppend.to(String)