doc / ch.tutteli.atrium.api.infix.en_GB / withRepresentation

withRepresentation

infix fun <T> RootExpect<T>.withRepresentation(textRepresentation: String): Expect<T> (source)

Wraps the given textRepresentation into a Text and uses it as representation of the subject instead of the representation that has been defined so far (which defaults to the subject itself).

In case the subject of this expectation is not defined (i.e. _logic.maybeSubject is None), then the previous representation is used.

infix fun <T> RootExpect<T>.withRepresentation(representationProvider: (T) -> Any): Expect<T> (source)

Uses the given representationProvider to retrieve a representation which can be based on the current subject where it is used as new representation of the subject instead of the representation that has been defined so far (which defaults to the subject itself).

Notice, if you want to use text (a String which is treated as raw string in reporting) as representation, then wrap it into a Text and pass it instead. If your text does not include the current subject, then we recommend to use the other overload which expects a String and does the wrapping for you.

In case the subject of this expectation is not defined (i.e. _logic.maybeSubject is None), then the previous representation is used.

infix fun <T, R> FeatureExpect<T, R>.withRepresentation(textRepresentation: String): Expect<R> (source)

Wraps the given textRepresentation into a Text and uses it as representation of the subject instead of the representation that has been defined so far (which defaults to the subject itself).

In case the subject of this expectation is not defined (i.e. _logic.maybeSubject is None), then the previous representation is used.

Return
An new Expect with the specified options for subject of this expectation.

infix fun <T, R> FeatureExpect<T, R>.withRepresentation(representationProvider: (R) -> Any): Expect<R> (source)

Uses the given representationProvider to retrieve a representation which can be based on the current subject where it is used as new representation of the subject instead of the representation that has been defined so far (which defaults to the subject itself).

Notice, if you want to use text (a String which is treated as raw string in reporting) as representation, then wrap it into a Text and pass it instead. If your text does not include the current subject, then we recommend to use the other overload which expects a String and does the wrapping for you.

In case the subject of this expectation is not defined (i.e. _logic.maybeSubject is None), then the previous representation is used.

Return
An new Expect with the specified options for subject of this expectation.