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

exactly

fun <T : CharSequence, S : CharSequenceContains.SearchBehaviour> CharSequenceContains.EntryPointStep<T, S>.exactly(times: Int): ExactlyCheckerStep<T, S>(source)

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

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

In case times is zero; use notToContain instead.

Samples

expect("ABCBAC").toContain.exactly(2).value("C")

fails {
    expect("ABBBBCD").toContain.exactly(3).value("B")
}
fun <E, T : IterableLike, S : InAnyOrderSearchBehaviour> IterableLikeContains.EntryPointStep<E, T, S>.exactly(times: Int): ExactlyCheckerStep<E, T, S>(source)

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

Return

The newly created builder.

Since

0.14.0 -- API existed for Iterable but not for IterableLike.

Parameters

times

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

Throws

In case times is zero; use notToContain instead.

Samples

expect(listOf("A", "B", "A")).toContain.inAnyOrder.exactly(2).entry {
    toEqual("A")
}

expect(listOf(1, 2, 3)).toContain.inAnyOrder.exactly(2).entry {
    toBeGreaterThan(1)
}

fails {
    expect(listOf("A", "B", "A", "C")).toContain.inAnyOrder.exactly(2).entry {
        toEqual("B")
    }
}

fails {
    expect(listOf(1, 2, 3)).toContain.inAnyOrder.exactly(2).entry {
        toBeLessThanOrEqualTo(1)
    }
}