fun <T : CharSequence> Expect<T>.containsRegex(pattern: String, vararg otherPatterns: String): Expect<T>
(source)
Expects that the subject of this
expectation (a CharSequence) contains a sequence which matches the given
regular expression pattern as well as the otherPatterns (if given), using a non disjoint search.
It is a shortcut for contains.atLeast(1).regex(pattern, *otherPatterns)
.
By non disjoint is meant that "aa"
in "aaaa"
is found three times and not only two times.
Also notice, that it does not search for unique matches. Meaning, if the input of the search is "ab"
and pattern
is defined as "a(b)?"
and one of the otherPatterns is defined as "a(b)?"
as well, then both match, even though
they match the same sequence in the input of the search. Use an option such as atLeast, atMost and exactly to
control the number of occurrences you expect.
Meaning you might want to use:
contains.exactly(2).regex("a(b)?")
instead of:
contains.atLeast(1).regex("a(b)?", "a(b)?")
expect("ABC").containsRegex("A(B)?")
fails {
expect("ABC").containsRegex("X")
}
expect("ABC")
.containsRegex("A(B)?", "(B)?C") // all regex patterns match
// holds because `containsRegex` does not search for unique matches
// use `contains.exactly(2).regex("A(B)?")` to check if subject contains the regex two times
expect("ABC")
.containsRegex("A(B)?", "A(B)?")
fails { // because second regex doesn't match
expect("ABC").containsRegex("A", "X")
}
pattern
- The pattern which is expected to have a match against the input of the search.
otherPatterns
- Additional patterns which are expected to have a match against the input of the search.
Return
an Expect for the subject of this
expectation.
fun <T : CharSequence> Expect<T>.containsRegex(pattern: Regex, vararg otherPatterns: Regex): Expect<T>
(source)
Expects that the subject of this
expectation (a CharSequence) contains a sequence which matches the given
regular expression pattern as well as the otherPatterns (if given), using a non disjoint search.
It is a shortcut for contains.atLeast(1).regex(pattern, *otherPatterns)
.
By non disjoint is meant that "aa"
in "aaaa"
is found three times and not only two times.
Also notice, that it does not search for unique matches. Meaning, if the input of the search is "ab"
and pattern
is defined as "a(b)?"
and one of the otherPatterns is defined as "a(b)?"
as well, then both match, even though
they match the same sequence in the input of the search. Use an option such as atLeast, atMost and exactly to
control the number of occurrences you expect.
Meaning you might want to use:
contains.exactly(2).regex(Regex("a(b)?"))
instead of:
contains.atLeast(1).regex(Regex("a(b)?"), Regex("a(b)?"))
expect("ABC").containsRegex("(B)?C".toRegex())
fails {
expect("ABC").containsRegex("X".toRegex())
}
expect("ABC")
.containsRegex("A".toRegex(), "B".toRegex()) // all regex patterns match
// holds because `containsRegex` does not search for unique matches
// use `contains.exactly(2).regex(regex)` to check if subject contains the regex two times
val regex = "A(B)?".toRegex()
expect("ABC").containsRegex(regex, regex)
fails { // because second regex doesn't match
expect("ABC").containsRegex("A".toRegex(), "X".toRegex())
}
pattern
- The pattern which is expected to have a match against the input of the search.
otherPatterns
- Additional patterns which are expected to have a match against the input of the search.
Return
an Expect for the subject of this
expectation.
Since
0.9.0