Class Strings
- java.lang.Object
-
- com.impossibl.postgres.utils.guava.Strings
-
public class Strings extends Object
-
-
Constructor Summary
Constructors Constructor Description Strings()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static String
emptyToNull(String string)
Returns the given string if it is nonempty;null
otherwise.static boolean
isNullOrEmpty(String string)
Returnstrue
if the given string is null or is the empty string.static String
nullToEmpty(String string)
Returns the given string if it is non-null; the empty string otherwise.static String
padEnd(String string, int minLength, char padChar)
Returns a string, of length at leastminLength
, consisting ofstring
appended with as many copies ofpadChar
as are necessary to reach that length.static String
padStart(String string, int minLength, char padChar)
Returns a string, of length at leastminLength
, consisting ofstring
prepended with as many copies ofpadChar
as are necessary to reach that length.static String
repeat(String string, int count)
Returns a string consisting of a specific number of concatenated copies of an input string.
-
-
-
Method Detail
-
nullToEmpty
public static String nullToEmpty(String string)
Returns the given string if it is non-null; the empty string otherwise.- Parameters:
string
- the string to test and possibly return- Returns:
string
itself if it is non-null;""
if it is null
-
emptyToNull
public static String emptyToNull(String string)
Returns the given string if it is nonempty;null
otherwise.- Parameters:
string
- the string to test and possibly return- Returns:
string
itself if it is nonempty;null
if it is empty or null
-
isNullOrEmpty
public static boolean isNullOrEmpty(String string)
Returnstrue
if the given string is null or is the empty string.Consider normalizing your string references with
nullToEmpty(java.lang.String)
. If you do, you can useString.isEmpty()
instead of this method, and you won't need special null-safe forms of methods likeString.toUpperCase(java.util.Locale)
either. Or, if you'd like to normalize "in the other direction," converting empty strings tonull
, you can useemptyToNull(java.lang.String)
.- Parameters:
string
- a string reference to check- Returns:
true
if the string is null or is the empty string
-
padStart
public static String padStart(String string, int minLength, char padChar)
Returns a string, of length at leastminLength
, consisting ofstring
prepended with as many copies ofpadChar
as are necessary to reach that length. For example,padStart("7", 3, '0')
returns"007"
padStart("2010", 3, '0')
returns"2010"
- Parameters:
string
- the string which should appear at the end of the resultminLength
- the minimum length the resulting string must have. Can be zero or negative, in which case the input string is always returned.padChar
- the character to insert at the beginning of the result until the minimum length is reached- Returns:
- the padded string
-
padEnd
public static String padEnd(String string, int minLength, char padChar)
Returns a string, of length at leastminLength
, consisting ofstring
appended with as many copies ofpadChar
as are necessary to reach that length. For example,padEnd("4.", 5, '0')
returns"4.000"
padEnd("2010", 3, '!')
returns"2010"
- Parameters:
string
- the string which should appear at the beginning of the resultminLength
- the minimum length the resulting string must have. Can be zero or negative, in which case the input string is always returned.padChar
- the character to append to the end of the result until the minimum length is reached- Returns:
- the padded string
-
repeat
public static String repeat(String string, int count)
Returns a string consisting of a specific number of concatenated copies of an input string. For example,repeat("hey", 3)
returns the string"heyheyhey"
.- Parameters:
string
- any non-null stringcount
- the number of times to repeat it; a nonnegative integer- Returns:
- a string containing
string
repeatedcount
times (the empty string ifcount
is zero) - Throws:
IllegalArgumentException
- ifcount
is negative
-
-