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

only

@get:JvmName(name = "butOnly")

val <E, T : IterableLike> IterableLikeContains.EntryPointStep<E, T, InAnyOrderSearchBehaviour>.only: IterableLikeContains.EntryPointStep<E, T, InAnyOrderOnlySearchBehaviour>(source)

Defines that the constraint "only the specified entries exist in the IterableLike" shall be applied to this sophisticated to contain in IterableLike expectation.

Return

The newly created builder.

Since

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

@get:JvmName(name = "andOnly")

val <E, T : IterableLike> IterableLikeContains.EntryPointStep<E, T, InOrderSearchBehaviour>.only: IterableLikeContains.EntryPointStep<E, T, InOrderOnlySearchBehaviour>(source)

Defines that the constraint "only the specified entries exist in the IterableLike" shall be applied to this sophisticated to contain in order in IterableLike expectation.

Return

The newly created builder.

Since

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

@get:JvmName(name = "butOnly")

val <K, V, T : MapLike> MapLikeContains.EntryPointStep<K, V, T, InAnyOrderSearchBehaviour>.only: MapLikeContains.EntryPointStep<K, V, T, InAnyOrderOnlySearchBehaviour>(source)

Defines that the constraint "only the specified entries exist in the MapLike" shall be applied to this sophisticated to contain MapLike expectation.

Return

The newly created builder.

Since

0.15.0

Samples

expect(mapOf(1 to "a")).toContain.inAnyOrder.only.entry(1 to "a")

fails { // because subject has additional entries
    expect(mapOf(1 to "a", 2 to "b"))
        .toContain.inAnyOrder.only.entry(1 to "a")
}

@get:JvmName(name = "andOnly")

val <K, V, T : MapLike> MapLikeContains.EntryPointStep<K, V, T, InOrderSearchBehaviour>.only: MapLikeContains.EntryPointStep<K, V, T, InOrderOnlySearchBehaviour>(source)

Defines that the constraint "only the specified entries exist in the MapLike" shall be applied to this sophisticated to contain in order MapLike expectation.

Return

The newly created builder.

Since

0.15.0

Samples

expect(mapOf(1 to "a")).toContain.inOrder.only.entry(1 to "a")

fails { // because the entry 1="a" (which exists in the subject) is not the only entry
    expect(mapOf(1 to "a", 2 to "b")).toContain.inOrder.only.entry(1 to "a")
}