Package org.assertj.core.internal
Class Strings
java.lang.Object
org.assertj.core.internal.Strings
Reusable assertions for
CharSequences.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final ComparisonStrategyprivate static final String(package private) Failuresprivate static final Stringsprivate static final String -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprivate booleanareEqualIgnoringCase(CharSequence actual, CharSequence expected) private booleanareEqualIgnoringWhitespace(CharSequence actual, CharSequence expected) voidassertBlank(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceisNull, empty or consists of one or more whitespace characters.voidassertContains(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencecontains the given strings.voidassertContainsAnyOf(AssertionInfo info, CharSequence actual, CharSequence[] values) voidassertContainsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence sequence) Verifies that the givenCharSequencecontains the given sequence, ignoring case considerations.voidassertContainsIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies the givenCharSequencehas the strings, ignoring newlines.voidassertContainsIgnoringWhitespaces(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencecontains the given strings, ignoring whitespaces.voidassertContainsOnlyDigits(AssertionInfo info, CharSequence actual) Verifies that the givenCharSequencecontains only digits.voidassertContainsOnlyOnce(AssertionInfo info, CharSequence actual, CharSequence sequence) Verifies that actualCharSequences contains only once the given sequence.voidassertContainsOnlyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceconsists of one or more whitespace characters.voidassertContainsPattern(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the givenCharSequencecontains the given regular expression.voidassertContainsPattern(AssertionInfo info, CharSequence actual, Matcher matcher) Verifies that the givenCharSequencecontains the given regular expression.voidassertContainsPattern(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the givenCharSequencecontains the given regular expression.voidassertContainsSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence) Verifies that the given charSequence contains the given sequence of charSequence, without any other charSequences between them.voidassertContainsSubsequence(AssertionInfo info, CharSequence actual, CharSequence[] subsequence) Verifies that the actualCharSequencecontains all the given values in the given order (possibly with other values between them).voidassertContainsWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequencecontains one or more whitespace characters.voidassertDoesNotContain(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencedoes not contain any one of the given values.voidassertDoesNotContainAnyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceisNull, empty or contains only non-whitespace characters.voidassertDoesNotContainIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencedoes not contain any one of the given values, ignoring case considerations.voidassertDoesNotContainOnlyWhitespaces(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceisNull, empty or contains at least one non-whitespace character.voidassertDoesNotContainPattern(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the givenCharSequencedoes not contain the given regular expression.voidassertDoesNotContainPattern(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the givenCharSequencedoes not contain the given regular expression.voidassertDoesNotEndWith(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequencedoes not end with the given suffix.voidassertDoesNotEndWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequencedoes not end with the given suffix, ignoring case considerations.voidassertDoesNotMatch(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the givenCharSequencedoes not match the given regular expression.voidassertDoesNotMatch(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the givenCharSequencedoes not match the given regular expression.voidassertDoesNotStartWith(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencedoes not start with the given prefix.voidassertDoesNotStartWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencedoes not start with the given prefix, ignoring case considerations.voidassertEmpty(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceis empty.voidassertEndsWith(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequenceends with the given suffix.voidassertEndsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequenceends with the given suffix, ignoring case considerations.voidassertEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, ignoring case considerations.voidassertEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, ignoring any differences in whitespace.voidassertEqualsNormalizingPunctuationAndWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, after the punctuation of both strings have been normalized.voidassertEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, after the whitespace of both strings has been normalized.voidassertEqualsToNormalizingUnicode(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, on their canonical form relying onNormalizer.voidassertHasLineCount(AssertionInfo info, CharSequence actual, int expectedLineCount) Asserts that the line count of the givenCharSequenceis equal to the expected one.voidassertHasSameSizeAs(AssertionInfo info, CharSequence actual, CharSequence other) voidassertHasSameSizeAs(AssertionInfo info, CharSequence actual, Iterable<?> other) Asserts that the number of entries in the givenCharSequencehas the same size as the otherIterable.voidassertHasSameSizeAs(AssertionInfo info, CharSequence actual, Object array) Asserts that the number of entries in the givenCharSequencehas the same size as the other array.voidassertHasSize(AssertionInfo info, CharSequence actual, int expectedSize) Asserts that the size of the givenCharSequenceis equal to the expected one.voidassertHasSizeBetween(AssertionInfo info, CharSequence actual, int lowerBoundary, int higherBoundary) Asserts that the size of the givenCharSequenceis between the given lower and higher boundary (inclusive).voidassertHasSizeGreaterThan(AssertionInfo info, CharSequence actual, int expectedMinSizeExcluded) Asserts that the size of the givenCharSequenceis greater than the expected sizevoidassertHasSizeGreaterThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMinSizeIncluded) Asserts that the size of the givenCharSequenceis greater than or equal to the expected sizevoidassertHasSizeLessThan(AssertionInfo info, CharSequence actual, int expectedMaxSizeExcluded) Asserts that the size of the givenCharSequenceis less than the expected sizevoidassertHasSizeLessThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMaxSizeIncluded) Asserts that the size of the givenCharSequenceis less than or equal to the expected sizevoidassertIsBase64(AssertionInfo info, String actual) Verifies that actual is a valid Base64 encoded string.voidassertIsEqualToIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that actual is equal to expected ignoring new linesvoidassertIsEqualToNormalizingNewlines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, normalizing newlines.voidassertIsSubstringOf(AssertionInfo info, CharSequence actual, CharSequence sequence) voidassertJavaBlank(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceconsists of one or more whitespace characters according toCharacter.isWhitespace(char).voidassertLowerCase(AssertionInfo info, CharSequence actual) voidassertMatches(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the givenCharSequencematches the given regular expression.voidassertMatches(AssertionInfo info, CharSequence actual, Matcher matcher) Verifies that the givenCharSequencematches the given regular expression.voidassertMatches(AssertionInfo info, CharSequence actual, Pattern pattern) Verifies that the givenCharSequencematches the given regular expression.voidassertMixedCase(AssertionInfo info, CharSequence actual) voidassertNotBlank(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequencecontains at least one non-whitespace character.voidassertNotEmpty(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceis not empty.voidassertNotEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, ignoring case considerations.voidassertNotEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, ignoring any differences in whitespace.voidassertNotEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, after the whitespace of both strings has been normalized.voidassertNotJavaBlank(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceisNull, empty or contains at least one non-whitespace character according toCharacter.isWhitespace(char).private voidassertNotNull(AssertionInfo info, CharSequence actual) voidassertNullOrEmpty(AssertionInfo info, CharSequence actual) Asserts that the givenCharSequenceisnullor empty.voidassertStartsWith(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencestarts with the given prefix.voidassertStartsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencestarts with the given prefix, ignoring case considerations.voidassertUpperCase(AssertionInfo info, CharSequence actual) voidassertVisible(AssertionInfo info, CharSequence actual) voidassertXmlEqualsTo(AssertionInfo info, CharSequence actualXml, CharSequence expectedXml) private voidprivate static voidcheckCharSequenceIsNotNull(CharSequence sequence) private voidcheckIsNotEmpty(CharSequence... values) private voidcheckIsNotNull(CharSequence... values) private voidcheckIsNotNull(Matcher matcher) private voidcheckIsNotNull(Pattern pattern) private voidcheckRegexIsNotNull(CharSequence regex) private booleancontainsIgnoreCase(CharSequence actual, CharSequence sequence) private booleanprivate booleancontainsOnlyWhitespaces(CharSequence actual) private booleancontainsWhitespaces(CharSequence actual) private intcountOccurrences(CharSequence sequenceToSearch, CharSequence actual) Count occurrences of sequenceToSearch in actualCharSequence.private voiddoCommonCheckForCharSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence) private booleanendsWith(CharSequence actual, CharSequence suffix, boolean ignoreCase) private static voidfailIfPrefixIsNull(CharSequence prefix) private static voidfailIfSuffixIsNull(CharSequence suffix) Comparator<?> private static booleanprivate intindexOf(String string, CharSequence toFind) static Stringsinstance()Returns the singleton instance of this class based onStandardComparisonStrategy.private booleanisBlank(CharSequence actual) private booleanisJavaBlank(CharSequence actual) private booleanisLowerCase(CharSequence actual) private booleanisNullOrEmpty(CharSequence actual) private booleanisUpperCase(CharSequence actual) private static StringnormalizeNewlines(CharSequence actual) private static StringnormalizeWhitespace(CharSequence toNormalize) private static StringnormalizeWhitespaceAndPunctuation(CharSequence toNormalize) private NullPointerExceptionprivate static StringremoveAllWhitespaces(CharSequence toBeStripped) private static StringremoveNewLines(CharSequence text) private StringremoveUpTo(String string, CharSequence toRemove) private booleanstartsWith(CharSequence actual, CharSequence prefix, boolean ignoreCase) private booleanprivate booleanstringContains(CharSequence actual, CharSequence sequence)
-
Field Details
-
EMPTY_STRING
- See Also:
-
INSTANCE
-
PUNCTUATION_REGEX
- See Also:
-
comparisonStrategy
-
failures
Failures failures
-
-
Constructor Details
-
Strings
Strings() -
Strings
-
-
Method Details
-
instance
Returns the singleton instance of this class based onStandardComparisonStrategy.- Returns:
- the singleton instance of this class based on
StandardComparisonStrategy.
-
getComparator
-
assertNullOrEmpty
Asserts that the givenCharSequenceisnullor empty.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis notnull*and* it is not empty.
-
assertEmpty
Asserts that the givenCharSequenceis empty.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequenceis not empty.
-
assertNotEmpty
Asserts that the givenCharSequenceis not empty.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequenceis empty.
-
hasContent
-
assertBlank
Asserts that the givenCharSequenceisNull, empty or consists of one or more whitespace characters.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis not blank.
-
assertNotBlank
Asserts that the givenCharSequencecontains at least one non-whitespace character.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis blank.
-
isBlank
-
containsWhitespaces
-
containsOnlyWhitespaces
-
isNullOrEmpty
-
containsOneOrMoreWhitespaces
-
strictlyContainsWhitespaces
-
assertContainsWhitespaces
Asserts that the givenCharSequencecontains one or more whitespace characters.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequencedoes not contain any whitespace characters.
-
assertContainsOnlyWhitespaces
Asserts that the givenCharSequenceconsists of one or more whitespace characters.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis not blank.
-
assertDoesNotContainAnyWhitespaces
Asserts that the givenCharSequenceisNull, empty or contains only non-whitespace characters.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequencecontains one or more whitespace characters.
-
assertDoesNotContainOnlyWhitespaces
Asserts that the givenCharSequenceisNull, empty or contains at least one non-whitespace character.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis blank.
-
assertJavaBlank
Asserts that the givenCharSequenceconsists of one or more whitespace characters according toCharacter.isWhitespace(char).- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis not blank.
-
assertNotJavaBlank
Asserts that the givenCharSequenceisNull, empty or contains at least one non-whitespace character according toCharacter.isWhitespace(char).- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
AssertionError- if the givenCharSequenceis blank.
-
isJavaBlank
-
assertHasSize
Asserts that the size of the givenCharSequenceis equal to the expected one.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedSize- the expected size ofactual.- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the size of the givenCharSequenceis different than the expected one.
-
assertHasSizeLessThan
public void assertHasSizeLessThan(AssertionInfo info, CharSequence actual, int expectedMaxSizeExcluded) Asserts that the size of the givenCharSequenceis less than the expected size- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedMaxSizeExcluded- the expected max size ofactual- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the size of the givenCharSequenceis equal to or greater than the expected max size
-
assertHasSizeLessThanOrEqualTo
public void assertHasSizeLessThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMaxSizeIncluded) Asserts that the size of the givenCharSequenceis less than or equal to the expected size- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedMaxSizeIncluded- the expected max size ofactual- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the size of the givenCharSequenceis greater than the expected max size
-
assertHasSizeGreaterThan
public void assertHasSizeGreaterThan(AssertionInfo info, CharSequence actual, int expectedMinSizeExcluded) Asserts that the size of the givenCharSequenceis greater than the expected size- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedMinSizeExcluded- the expected min size ofactual- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the size of the givenCharSequenceis equal to or less than the expected max size
-
assertHasSizeGreaterThanOrEqualTo
public void assertHasSizeGreaterThanOrEqualTo(AssertionInfo info, CharSequence actual, int expectedMinSizeIncluded) Asserts that the size of the givenCharSequenceis greater than or equal to the expected size- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedMinSizeIncluded- the expected min size ofactual- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the size of the givenCharSequenceis greater than the expected max size
-
assertHasSizeBetween
public void assertHasSizeBetween(AssertionInfo info, CharSequence actual, int lowerBoundary, int higherBoundary) Asserts that the size of the givenCharSequenceis between the given lower and higher boundary (inclusive).- Parameters:
info- contains information about the assertion.actual- the givenIterable.lowerBoundary- the lower boundary compared to which actual size should be greater than or equal to.higherBoundary- the higher boundary compared to which actual size should be less than or equal to.- Throws:
AssertionError- if the given array isnull.AssertionError- if the number of elements in the given array is not between the boundaries.
-
assertHasLineCount
Asserts that the line count of the givenCharSequenceis equal to the expected one.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.expectedLineCount- the expected line count ofactual.- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the line count of the givenCharSequenceis different than the expected one.
-
assertHasSameSizeAs
Asserts that the number of entries in the givenCharSequencehas the same size as the otherIterable.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.other- the group to compare- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenIterableisnull.AssertionError- if the number of entries in the givenCharSequencedoes not have the same size.
-
assertHasSameSizeAs
Asserts that the number of entries in the givenCharSequencehas the same size as the other array.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.array- the array to compare- Throws:
AssertionError- if the givenCharSequenceisnull.AssertionError- if the given array isnull.AssertionError- if the number of entries in the givenCharSequencedoes not have the same size.
-
assertHasSameSizeAs
-
assertContains
Verifies that the givenCharSequencecontains the given strings.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.values- the values to look for.- Throws:
NullPointerException- if the given sequence isnull.IllegalArgumentException- if the given values is empty.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contain the given sequence.
-
assertContainsAnyOf
-
assertContainsOnlyDigits
Verifies that the givenCharSequencecontains only digits.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.- Throws:
NullPointerException- ifactualisnull.AssertionError- ifactualcontains non-digit characters or contains no digits at all.
-
checkIsNotNull
-
checkIsNotEmpty
-
stringContains
-
assertContainsIgnoringCase
public void assertContainsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence sequence) Verifies that the givenCharSequencecontains the given sequence, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.sequence- the sequence to search for.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contain the given sequence.
-
containsIgnoreCase
-
assertContainsIgnoringNewLines
public void assertContainsIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies the givenCharSequencehas the strings, ignoring newlines.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.values- the values to look for.- Throws:
NullPointerException- if the given sequence isnull.IllegalArgumentException- if the given values is empty.AssertionError- if the givenCharSequenceisnull.AssertionError- if actualCharSequencedoesn't have sequence
-
assertContainsIgnoringWhitespaces
public void assertContainsIgnoringWhitespaces(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencecontains the given strings, ignoring whitespaces.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.values- the values to look for.- Throws:
NullPointerException- if the given sequence isnull.IllegalArgumentException- if the given values is empty.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contain the given sequence.
-
assertDoesNotContainIgnoringCase
public void assertDoesNotContainIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence... values) Verifies that the givenCharSequencedoes not contain any one of the given values, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.values- the sequences to search for.- Throws:
NullPointerException- if the given list of values isnull.NullPointerException- if any one of the given values isnull.IllegalArgumentException- if the list of given values is empty.AssertionError- if the actualCharSequenceisnull.AssertionError- if the actualCharSequencecontains any one of the given values, ignoring case considerations.
-
assertDoesNotContain
Verifies that the givenCharSequencedoes not contain any one of the given values.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.values- the values to search for.- Throws:
NullPointerException- if the given list of values isnull.NullPointerException- if any one of the given values isnull.IllegalArgumentException- if the list of given values is empty.AssertionError- if the actualCharSequenceisnull.AssertionError- if the actualCharSequencecontains any one of the given values.
-
checkCharSequenceIsNotNull
-
assertEqualsIgnoringCase
public void assertEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are not equal.
-
assertNotEqualsIgnoringCase
public void assertNotEqualsIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are equal ignoring case considerations.
-
areEqualIgnoringCase
-
assertIsEqualToNormalizingNewlines
public void assertIsEqualToNormalizingNewlines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, normalizing newlines.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence(newlines will be normalized).expected- the expectedCharSequence(newlines will be normalized)..- Throws:
AssertionError- if the givenCharSequences are equal after normalizing newlines.
-
normalizeNewlines
-
assertEqualsIgnoringWhitespace
public void assertEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, ignoring any differences in whitespace.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are not equal.
-
assertNotEqualsIgnoringWhitespace
public void assertNotEqualsIgnoringWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, ignoring any differences in whitespace.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are equal.
-
areEqualIgnoringWhitespace
-
removeAllWhitespaces
-
assertEqualsNormalizingWhitespace
public void assertEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, after the whitespace of both strings has been normalized.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are not equal.- Since:
- 2.8.0 / 3.8.0
-
assertNotEqualsNormalizingWhitespace
public void assertNotEqualsNormalizingWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are not equal, after the whitespace of both strings has been normalized.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are equal.- Since:
- 2.8.0 / 3.8.0
-
normalizeWhitespace
-
assertEqualsNormalizingPunctuationAndWhitespace
public void assertEqualsNormalizingPunctuationAndWhitespace(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, after the punctuation of both strings have been normalized.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are not equal.- Since:
- 3.16.0
-
normalizeWhitespaceAndPunctuation
-
assertEqualsToNormalizingUnicode
public void assertEqualsToNormalizingUnicode(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that twoCharSequences are equal, on their canonical form relying onNormalizer. UsingNormalizer.Form.NFCfor canonical decomposition, followed by canonical composition.Examples:
// assertion succeeds assertThat("Ä").isEqualToNormalizingUnicode("Ä"); // assertion fails assertThat("Ä").isEqualToNormalizingUnicode("Ä");- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.expected- the expectedCharSequence.- Throws:
AssertionError- if the givenCharSequences are not equal.- Since:
- 3.19.0
-
assertContainsOnlyOnce
Verifies that actualCharSequences contains only once the given sequence.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.sequence- the givenCharSequence.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contains only once the givenCharSequence.
-
countOccurrences
Count occurrences of sequenceToSearch in actualCharSequence.- Parameters:
sequenceToSearch- the sequence to search in in actualCharSequence.actual- theCharSequenceto search occurrences in.- Returns:
- the number of occurrences of sequenceToSearch in actual
CharSequence.
-
assertStartsWith
Verifies that the givenCharSequencestarts with the given prefix.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.prefix- the given prefix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not start with the given prefix.
-
assertStartsWithIgnoringCase
public void assertStartsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencestarts with the given prefix, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.prefix- the given prefix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not start with the given prefix, ignoring case.- Since:
- 3.23.0
-
assertDoesNotStartWith
Verifies that the givenCharSequencedoes not start with the given prefix.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.prefix- the given prefix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencestarts with the given prefix.
-
assertDoesNotStartWithIgnoringCase
public void assertDoesNotStartWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence prefix) Verifies that the givenCharSequencedoes not start with the given prefix, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.prefix- the given prefix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencestarts with the given prefix, ignoring case.- Since:
- 3.23.0
-
failIfPrefixIsNull
-
startsWith
-
assertEndsWith
Verifies that the givenCharSequenceends with the given suffix.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.suffix- the given suffix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not end with the given suffix.
-
assertEndsWithIgnoringCase
public void assertEndsWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequenceends with the given suffix, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.suffix- the given suffix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not end with the given suffix, ignoring case.- Since:
- 3.23.0
-
assertDoesNotEndWith
Verifies that the givenCharSequencedoes not end with the given suffix.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.suffix- the given suffix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequenceends with the given suffix.
-
assertDoesNotEndWithIgnoringCase
public void assertDoesNotEndWithIgnoringCase(AssertionInfo info, CharSequence actual, CharSequence suffix) Verifies that the givenCharSequencedoes not end with the given suffix, ignoring case considerations.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence.suffix- the given suffix.- Throws:
NullPointerException- if the given sequence isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequenceends with the given suffix, ignoring case.- Since:
- 3.23.0
-
failIfSuffixIsNull
-
endsWith
-
assertMatches
Verifies that the givenCharSequencematches the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.regex- the regular expression to which the actualCharSequenceis to be matched.- Throws:
NullPointerException- if the given pattern isnull.PatternSyntaxException- if the regular expression's syntax is invalid.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not match the given regular expression.
-
assertDoesNotMatch
Verifies that the givenCharSequencedoes not match the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.regex- the regular expression to which the actualCharSequenceis to be matched.- Throws:
NullPointerException- if the given pattern isnull.PatternSyntaxException- if the regular expression's syntax is invalid.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencematches the given regular expression.
-
checkRegexIsNotNull
-
assertMatches
Verifies that the givenCharSequencematches the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.pattern- the regular expression to which the actualCharSequenceis to be matched.- Throws:
NullPointerException- if the given pattern isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequencedoes not match the given regular expression.
-
assertMatches
Verifies that the givenCharSequencematches the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.matcher- the matcher to check for matching.- Throws:
NullPointerException- if the given pattern isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequencedoes not match the given regular expression.
-
assertDoesNotMatch
Verifies that the givenCharSequencedoes not match the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.pattern- the regular expression to which the actualCharSequenceis to be matched.- Throws:
NullPointerException- if the given pattern isnull.AssertionError- if the givenCharSequencematches the given regular expression.
-
checkIsNotNull
-
patternToMatchIsNull
-
checkIsNotNull
-
assertNotNull
-
assertContainsSequence
public void assertContainsSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence) Verifies that the given charSequence contains the given sequence of charSequence, without any other charSequences between them.- Parameters:
info- contains information about the assertion.actual- the given charSequence.sequence- the sequence of charSequence to look for.- Throws:
NullPointerException- if the given sequence of charSequence isnull.IllegalArgumentException- if the given sequence of charSequence is empty.AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequencedoes not contain the given sequence of charSequence.
-
assertContainsSubsequence
public void assertContainsSubsequence(AssertionInfo info, CharSequence actual, CharSequence[] subsequence) Verifies that the actualCharSequencecontains all the given values in the given order (possibly with other values between them).- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.subsequence- the Strings to look for, in order.- Throws:
AssertionError- if the givenCharSequenceisnull.NullPointerException- if the given subsequence isnull.IllegalArgumentException- if the given subsequence is empty.AssertionError- if the givenCharSequencedoes not contain the given subsequence of charSequence.
-
removeUpTo
-
indexOf
-
assertXmlEqualsTo
-
assertIsSubstringOf
-
assertContainsPattern
Verifies that the givenCharSequencecontains the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.regex- the regular expression to find in the actualCharSequence.- Throws:
NullPointerException- if the given pattern isnull.PatternSyntaxException- if the regular expression's syntax is invalid.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contain the given regular expression.
-
assertContainsPattern
Verifies that the givenCharSequencecontains the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.matcher- the matcher for finding in the actualCharSequence.- Throws:
NullPointerException- if the given pattern isnull.PatternSyntaxException- if the regular expression's syntax is invalid.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencedoes not contain the given regular expression.
-
assertContainsPattern
Verifies that the givenCharSequencecontains the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.pattern- the regular expression to find in the actualCharSequence.- Throws:
NullPointerException- if the given pattern isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequencedoes not contain the given regular expression.
-
assertDoesNotContainPattern
public void assertDoesNotContainPattern(AssertionInfo info, CharSequence actual, CharSequence regex) Verifies that the givenCharSequencedoes not contain the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.regex- the regular expression to find in the actualCharSequence.- Throws:
NullPointerException- if the given pattern isnull.PatternSyntaxException- if the regular expression's syntax is invalid.AssertionError- if the givenCharSequenceisnull.AssertionError- if the actualCharSequencecontains the given regular expression.
-
assertDoesNotContainPattern
Verifies that the givenCharSequencedoes not contain the given regular expression.- Parameters:
info- contains information about the assertion.actual- the givenCharSequence.pattern- the regular expression to find in the actualCharSequence.- Throws:
NullPointerException- if the given pattern isnull.AssertionError- if the givenCharSequenceisnull.AssertionError- if the givenCharSequencecontains the given regular expression.
-
checkCharSequenceArrayDoesNotHaveNullElements
-
assertIsEqualToIgnoringNewLines
public void assertIsEqualToIgnoringNewLines(AssertionInfo info, CharSequence actual, CharSequence expected) Verifies that actual is equal to expected ignoring new lines- Parameters:
info- contains information about the assertion.actual- the actualCharSequence(new lines will be ignored).expected- the expectedCharSequence(new lines will be ignored).
-
assertLowerCase
-
isLowerCase
-
assertUpperCase
-
isUpperCase
-
assertMixedCase
-
assertIsBase64
Verifies that actual is a valid Base64 encoded string.- Parameters:
info- contains information about the assertion.actual- the actualCharSequence(new lines will be ignored).- Throws:
AssertionError- ifactualisnull.AssertionError- ifactualis not a valid Base64 encoded string.
-
removeNewLines
-
doCommonCheckForCharSequence
private void doCommonCheckForCharSequence(AssertionInfo info, CharSequence actual, CharSequence[] sequence) -
assertVisible
-