fun <T : CharSequence> CharSequenceContains.CheckerOption<T, NoOpSearchBehaviour>.values(expected: Any, vararg otherExpected: Any): AssertionPlant<T>
Finishes the specification of the sophisticated contains
assertion where the expected object as well as
the otherExpected objects 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 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 object which is expected to be contained within the input of the search.
otherExpected
- Additional objects 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
The AssertionPlant for which the assertion was built to support a fluent API.
@JvmName("valuesIgnoringCase") fun <T : CharSequence> CharSequenceContains.CheckerOption<T, IgnoringCaseSearchBehaviour>.values(expected: Any, vararg otherExpected: Any): AssertionPlant<T>
Finishes the specification of the sophisticated contains
assertion where the expected object as well as
the otherExpected objects 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 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 object which is expected to be contained within the input of the search.
otherExpected
- Additional objects 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
The AssertionPlant for which the assertion was built to support a fluent API.
fun <E : Any, T : Iterable<E>> IterableContains.CheckerOption<E, T, InAnyOrderSearchBehaviour>.values(expected: E, vararg otherExpected: E): AssertionPlant<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as the
otherExpected values 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 the Iterable.
otherExpected
- Additional objects which are expected to be contained within Iterable.
AssertionError
- Might throw an AssertionError if the assertion made is not correct.
Return
The AssertionPlant for which the assertion was built to support a fluent API.
fun <E, T : Iterable<E>> values(checkerBuilder: IterableContainsCheckerBuilder<E, T, InAnyOrderSearchBehaviour>, expected: E, vararg otherExpected: E): AssertionPlant<T>
fun <E, T : Iterable<E>> values(checkerBuilder: IterableContainsBuilder<E, T, InAnyOrderOnlySearchBehaviour>, expected: E, vararg otherExpected: E): AssertionPlant<T>
fun <E, T : Iterable<E>> values(checkerBuilder: IterableContainsBuilder<E, T, InOrderOnlySearchBehaviour>, expected: E, vararg otherExpected: E): AssertionPlant<T>
fun <E : Any, T : Iterable<E>> IterableContains.Builder<E, T, InAnyOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): AssertionPlant<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as the
otherExpected values need to be contained in Iterable where it does not matter in which order.
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
The AssertionPlant for which the assertion was built to support a fluent API.
fun <E : Any, T : Iterable<E>> IterableContains.Builder<E, T, InOrderOnlySearchBehaviour>.values(expected: E, vararg otherExpected: E): AssertionPlant<T>
Finishes the specification of the sophisticated contains
assertion where the expected value as well as the
otherExpected values need to be contained in Iterable in the specified order.
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
The AssertionPlant for which the assertion was built to support a fluent API.