doc / ch.tutteli.atrium.api.cc.de_CH / hoechstens

# hoechstens

`fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> CharSequenceContains.Builder<T, S>.`~~hoechstens~~(times: Int): AtMostCheckerOption<T, S>

**Deprecated:** api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0

Restricts a `contains`

assertion by specifying that the number of occurrences of the value which we
are looking for occurs `at least`

once but `at most`

number of times within the search input.

If you want to use a higher lower bound than one, then use `zumindest(2).aberHoechstens(3)`

instead of
`hoechstens(3)`

. And in case you want to state that it is either not contained at all or at most a certain
number of times, then use `nichtOderHoechstens(2)`

instead.

### Parameters

`times`

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

### Exceptions

`IllegalArgumentException`

- In case times is smaller than zero.

`IllegalArgumentException`

- In case times equals to zero; use enthaeltNicht instead.

`IllegalArgumentException`

- In case times equals to one; use genau instead.

**Return**

The newly created builder.

`fun <E, T : Iterable<E>, S : InAnyOrderSearchBehaviour> IterableContains.Builder<E, T, S>.`~~hoechstens~~(times: Int): AtMostCheckerOption<E, T, S>

**Deprecated:** api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0

Restricts a `contains`

assertion by specifying that the number of occurrences of the entry which we
are looking for occurs `at least`

once but `at most`

number of times within the Iterable.

If you want to use a higher lower bound than one, then use `zumindest(2).aberHoechstens(3)`

instead of `hoechstens(3)`

.
And in case you want to state that it is either not contained at all or at most a certain number of times,
then use `notOrAtMost(2)`

instead.

### Parameters

`times`

- The number which the check will compare against the number of times an expected entry is
found in the Iterable.

### Exceptions

`IllegalArgumentException`

- In case times is smaller than zero.

`IllegalArgumentException`

- In case times equals to zero; use enthaeltNicht instead.

`IllegalArgumentException`

- In case times equals to one; use genau instead.

**Return**

The newly created builder.

`fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> `~~hoechstens~~(builder: CharSequenceContainsBuilder<T, S>, times: Int): CharSequenceContainsAtMostCheckerBuilder<T, S>

**Deprecated:** Use the extension fun `hoechstens`. This fun is only here to retain binary compatibility; will be removed with 1.0.0

`fun <E, T : Iterable<E>> `~~hoechstens~~(builder: IterableContainsBuilder<E, T, InAnyOrderSearchBehaviour>, times: Int): IterableContainsAtMostCheckerBuilder<E, T>

**Deprecated:** Use the extension fun `hoechstens` instead. This fun is only here to retain binary compatibility; will be removed with 1.0.0