Class Strings

java.lang.Object
org.assertj.core.util.Strings

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

    • 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:
    • 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 if some args have been given otherwise just 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:
    • 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:
    • 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: