Package org.fest.util

Class Strings

  • public final class Strings
extends java.lang.Object
    Utility methods related to Strings.
    Author:
    Alex Ruiz

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class 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

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static Strings.StringToAppend append​(java.lang.String toAppend)
      Appends a given String to the given target, only if the target does not end with the given String to append.
      static java.lang.String concat​(java.lang.Object... objects)
      Concatenates the given objects into a single String.
      static boolean isEmpty​(java.lang.String s)
      Deprecated.
      static boolean isNullOrEmpty​(java.lang.String s)
      Indicates whether the given String is null or empty.
      static Strings.StringsToJoin join​(java.lang.String... strings)
      Joins the given Strings using a given delimiter.
      static java.lang.Object quote​(java.lang.Object o)
      Returns the given object surrounded by single quotes, only if the object is a String.
      static java.lang.String quote​(java.lang.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​(java.lang.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.

      • isEmpty

        @Deprecated
public static boolean isEmpty​(java.lang.String s)
        Deprecated.
        Only there for backward compatibility reasons - use isNullOrEmpty(String) instead.

      • quote

        public static java.lang.String quote​(java.lang.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 java.lang.Object quote​(java.lang.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 java.lang.String concat​(java.lang.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​(java.lang.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)

      • append

        public static Strings.StringToAppend append​(java.lang.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)