fun <T : CharSequence> CharSequenceContains.CheckerStep<T, NoOpSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
fun <T : CharSequence> CharSequenceContains.CheckerOption<T, NoOpSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as
the otherExpected values shall be searched, using a non disjoint search.
Notice that a runtime check applies which assures that only CharSequence, Number and Char are passed. This function expects CharSequenceOrNumberOrChar (which is a typealias for Any) for your convenience, so that you can mix String and Int for instance.
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 "a"
and expected
is defined as "a"
and one otherExpected is defined as "a"
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).value("a")
instead of:
contains.atLeast(1).values("a", "a")
expected
- The value which is expected to be contained within the input of the search.
otherExpected
- Additional values which are expected to be contained within the input of the search.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
IllegalArgumentException
- in case expected or one of the otherExpected is not a
CharSequence, Number or Char.
Return
An Expect for the current subject of the assertion.
@JvmName("valuesIgnoringCase") fun <T : CharSequence> CharSequenceContains.CheckerStep<T, IgnoringCaseSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
@JvmName("valuesIgnoringCase") fun <T : CharSequence> CharSequenceContains.CheckerOption<T, IgnoringCaseSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as
the otherExpected values shall be searched (ignoring case), using a non disjoint search.
Notice that a runtime check applies which assures that only CharSequence, Number and Char are passed. This function expects CharSequenceOrNumberOrChar (which is a typealias for Any) for your convenience, so that you can mix String and Int for instance.
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 "a"
and expected
is defined as "a"
and one otherExpected is defined as "a"
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.ignoringCase.exactly(2).value("a")
instead of:
contains.ignoringCase.atLeast(1).values("a", "a")
expected
- The value which is expected to be contained within the input of the search.
otherExpected
- Additional values which are expected to be contained within the input of the search.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
IllegalArgumentException
- in case expected or one of the otherExpected is not a
CharSequence, Number or Char.
Return
An Expect for the current subject of the assertion.
fun <T : CharSequence> CharSequenceContains.EntryPointStep<T, IgnoringCaseSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
fun <T : CharSequence> CharSequenceContains.Builder<T, IgnoringCaseSearchBehaviour>.values(expected: CharSequenceOrNumberOrChar, vararg otherExpected: CharSequenceOrNumberOrChar): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as
the otherExpected values shall be searched (ignoring case), using a non disjoint search
where each need to be contained at least once.
Delegates to atLeast(1).values(expected, otherExpected)
Notice that a runtime check applies which assures that only CharSequence, Number and Char are passed. This function expects CharSequenceOrNumberOrChar (which is a typealias for Any) for your convenience, so that you can mix String and Int for instance.
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 "a"
and expected
is defined as "a"
and one otherExpected is defined as "a"
as well, then both match, even though they match the
same sequence in the input of the search.
expected
- The value which is expected to be contained within the input of the search.
otherExpected
- Additional values which are expected to be contained within the input of the search.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
IllegalArgumentException
- in case expected or one of the otherExpected is not a
CharSequence, Number or Char.
Return
An Expect for the current subject of the assertion.
fun <E, T : Iterable<E>> IterableContains.CheckerOption<E, T, InAnyOrderSearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected
value as well as the otherExpected values (if given) shall be searched within the Iterable.
Notice, that it does not search for unique matches. Meaning, if the iterable is setOf('a', 'b')
and
expected is defined as 'a'
and one otherExpected is defined as 'a'
as well, then both match,
even though they match the same entry. Use an option such as atLeast, atMost and exactly to control the
number of occurrences you expect.
Meaning you might want to use:
contains.inAnyOrder.exactly(2).values('a')
instead of:
contains.inAnyOrder.atLeast(1).values('a', 'a')
expected
- The object which is expected to be contained within this Iterable.
otherExpected
- Additional objects which are expected to be contained within this Iterable.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E, T : Iterable<E>> IterableContains.Builder<E, T, InAnyOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected
value as well as the otherExpected values (if given) need to be
contained in Iterable where it does not matter in which order but only as
many entries should be returned by the Iterable as values defined.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
expected
- The value which is expected to be contained within the Iterable.
otherExpected
- Additional values which are expected to be contained within Iterable.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E, T : Iterable<E>> IterableContains.Builder<E, T, InOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the Iterable needs to contain only the
expected value as well as the otherExpected values
(if given) in the specified order.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
expected
- The value which is expected to be contained within the Iterable.
otherExpected
- Additional values which are expected to be contained within Iterable.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
fun <E, T> IterableLikeContains.CheckerStep<E, T, InAnyOrderSearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected
value as well as the otherExpected values (if given) shall be searched within the IterableLike.
Notice, that it does not search for unique matches. Meaning, if the iterable is setOf('a', 'b')
and
expected is defined as 'a'
and one otherExpected is defined as 'a'
as well, then both match,
even though they match the same entry. Use an option such as atLeast, atMost and exactly to control the
number of occurrences you expect.
Meaning you might want to use:
contains.inAnyOrder.exactly(2).values('a')
instead of:
contains.inAnyOrder.atLeast(1).values('a', 'a')
expected
- The object which is expected to be contained within this IterableLike.
otherExpected
- Additional objects which are expected to be contained within this IterableLike.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.
fun <E, T> IterableLikeContains.EntryPointStep<E, T, InAnyOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the expected
value as well as the otherExpected values (if given) need to be
contained in IterableLike where it does not matter in which order but only as
many entries should be returned by the IterableLike as values defined.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
expected
- The value which is expected to be contained within the IterableLike.
otherExpected
- Additional values which are expected to be contained within IterableLike.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.
fun <E, T> IterableLikeContains.EntryPointStep<E, T, InOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): Expect<T>
Finishes the specification of the sophisticated contains
assertion where the IterableLike
needs to contain only the expected value as well as the otherExpected values
(if given) in the specified order.
Note that we might change the signature of this function with the next version which will cause a binary backward compatibility break (see #292 for more information)
expected
- The value which is expected to be contained within the IterableLike.
otherExpected
- Additional values which are expected to be contained within IterableLike.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
Since
0.14.0 -- API existed for Iterable but not for IterableLike.
fun <K, V, T : Map<out K, V>> Expect<T>.values(assertionCreator: Expect<Collection<V>>.() -> Unit): Expect<T>
Expects that the property Map.keys of the subject of the assertion holds all assertions the given assertionCreator creates for it and returns an Expect for the current subject of the assertion.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
An Expect for the current subject of the assertion.
val <V, T : Map<*, V>> Expect<T>.values: Expect<Collection<V>>
Creates an Expect for the property Map.values of the subject of the assertion, so that further fluent calls are assertions about it.
Return
The newly created Expect for the extracted feature.