org.fest.util
Class Strings

java.lang.Object
  extended by org.fest.util.Strings

public final class Strings
extends Object

Understands utility methods related to Strings.

Author:
Alex Ruiz

Nested Class Summary
static class Strings.StringsToJoin
          Understands how to join Strings using a given delimiter.
static class Strings.StringToAppend
          Understands 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
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 boolean isEmpty(String s)
          Returns true if the given String is null or empty.
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

isEmpty

public static boolean isEmpty(String s)
Returns true if 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.

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 understands how to join the given Strings.
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");
 
which will result 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)


Copyright © 2007-2011 FEST (Fixtures for Easy Software Testing). All Rights Reserved.