atrium-api-fluent/ch.tutteli.atrium.api.fluent.en_GB/butAtMost

butAtMost

fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> AtLeastCheckerStep<T, S>.butAtMost(times: Int): ButAtMostCheckerStep<T, S>(source)

Restricts a contains at least assertion by specifying that the number of occurrences of the value which we are looking for occurs at most number of times within the search input.

The resulting restriction will be a contains at least but at most assertion.

Return

The newly created builder.

Parameters

times

The number which the check will compare against the actual number of times an expected value is found in the input of the search.

Throws

IllegalArgumentException

In case times of this at most restriction equals to the number of the at least restriction; use the exactly restriction instead.

Samples

expect("ABBC").toContain.atLeast(1).butAtMost(2).value("B")

fails {
    expect("ABBBBCD").toContain.atLeast(2).butAtMost(3).value("B")
}

fun <E, T : IterableLike, S : InAnyOrderSearchBehaviour> AtLeastCheckerStep<E, T, S>.butAtMost(times: Int): ButAtMostCheckerStep<E, T, S>(source)

Restricts a contains at least assertion by specifying that the number of occurrences of the entry which we are looking for occurs at most number of times within the IterableLike.