Package com.google.common.truth

Class StringSubject

java.lang.Object

com.google.common.truth.Subject

com.google.common.truth.ComparableSubject<String>

com.google.common.truth.StringSubject

public class StringSubject
extends ComparableSubject<String>

Propositions for string subjects.

Author:

David Saff, Christian Gruber (cgruber@israfil.net)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	StringSubject.CaseInsensitiveStringComparison	Case insensitive propositions for string subjects.

Nested classes/interfaces inherited from class com.google.common.truth.Subject

Subject.Factory<SubjectT extends Subject,ActualT>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	StringSubject(FailureMetadata metadata, @Nullable String string)	Constructor for use by subclasses.

Method Summary

Modifier and Type	Method	Description
void	contains(CharSequence string)	Fails if the string does not contain the given sequence.
void	containsMatch(String regex)	Fails if the string does not contain a match on the given regex.
void	containsMatch(Pattern regex)	Fails if the string does not contain a match on the given regex.
void	doesNotContain(CharSequence string)	Fails if the string contains the given sequence.
void	doesNotContainMatch(String regex)	Fails if the string contains a match on the given regex.
void	doesNotContainMatch(Pattern regex)	Fails if the string contains a match on the given regex.
void	doesNotMatch(String regex)	Fails if the string matches the given regex.
void	doesNotMatch(Pattern regex)	Fails if the string matches the given regex.
void	endsWith(String string)	Fails if the string does not end with the given string.
void	hasLength(int expectedLength)	Fails if the string does not have the given length.
StringSubject.CaseInsensitiveStringComparison	ignoringCase()	Returns a StringSubject-like instance that will ignore the case of the characters.
void	isEmpty()	Fails if the string is not equal to the zero-length "empty string."
void	isEquivalentAccordingToCompareTo(String other)	Deprecated. Use Subject.isEqualTo(java.lang.Object) instead.
void	isNotEmpty()	Fails if the string is equal to the zero-length "empty string."
void	matches(String regex)	Fails if the string does not match the given regex.
void	matches(Pattern regex)	Fails if the string does not match the given regex.
void	startsWith(String string)	Fails if the string does not start with the given string.

Methods inherited from class com.google.common.truth.ComparableSubject

isAtLeast, isAtMost, isGreaterThan, isIn, isLessThan, isNotIn

Methods inherited from class com.google.common.truth.Subject

actualCustomStringRepresentation, check, equals, failWithActual, failWithActual, failWithoutActual, hashCode, ignoreCheck, isAnyOf, isEqualTo, isIn, isInstanceOf, isNoneOf, isNotEqualTo, isNotIn, isNotInstanceOf, isNotNull, isNotSameInstanceAs, isNull, isSameInstanceAs, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

StringSubject

protected StringSubject(FailureMetadata metadata,
                        @Nullable String string)

Constructor for use by subclasses. If you want to create an instance of this class itself, call check(...).that(actual).

Method Detail

isEquivalentAccordingToCompareTo

@Deprecated
public final void isEquivalentAccordingToCompareTo(String other)

Deprecated.

Use Subject.isEqualTo(java.lang.Object) instead. String comparison is consistent with equality.

Description copied from class: ComparableSubject

Checks that the subject is equivalent to other according to Comparable.compareTo(T), (i.e., checks that a.comparesTo(b) == 0).

Note: Do not use this method for checking object equality. Instead, use Subject.isEqualTo(Object).

Overrides:

isEquivalentAccordingToCompareTo in class ComparableSubject<String>

hasLength

public void hasLength(int expectedLength)

Fails if the string does not have the given length.

isEmpty

public void isEmpty()

Fails if the string is not equal to the zero-length "empty string."

isNotEmpty

public void isNotEmpty()

Fails if the string is equal to the zero-length "empty string."

contains

public void contains(CharSequence string)

Fails if the string does not contain the given sequence.

doesNotContain

public void doesNotContain(CharSequence string)

Fails if the string contains the given sequence.

startsWith

public void startsWith(String string)

Fails if the string does not start with the given string.

endsWith

public void endsWith(String string)

Fails if the string does not end with the given string.

matches

public void matches(String regex)

Fails if the string does not match the given regex.

matches

@GwtIncompatible("java.util.regex.Pattern")
public void matches(Pattern regex)

Fails if the string does not match the given regex.

doesNotMatch

public void doesNotMatch(String regex)

Fails if the string matches the given regex.

doesNotMatch

@GwtIncompatible("java.util.regex.Pattern")
public void doesNotMatch(Pattern regex)

Fails if the string matches the given regex.

containsMatch

@GwtIncompatible("java.util.regex.Pattern")
public void containsMatch(Pattern regex)

Fails if the string does not contain a match on the given regex.

containsMatch

public void containsMatch(String regex)

Fails if the string does not contain a match on the given regex.

doesNotContainMatch

@GwtIncompatible("java.util.regex.Pattern")
public void doesNotContainMatch(Pattern regex)

Fails if the string contains a match on the given regex.

doesNotContainMatch

public void doesNotContainMatch(String regex)

Fails if the string contains a match on the given regex.

ignoringCase

public StringSubject.CaseInsensitiveStringComparison ignoringCase()

Returns a StringSubject-like instance that will ignore the case of the characters.

Character equality ignoring case is defined as follows: Characters must be equal either after calling Character.toLowerCase(char) or after calling Character.toUpperCase(char). Note that this is independent of any locale.