create

fun create(value: Any?): ValueWrapper

Factory for creating a new ValueWrapper for the supplied value.

If the supplied value is null, this method will return a cached ValueWrapper suitable for all null values. If the supplied value is already an instance of ValueWrapper, it will be returned as is.

Return

a wrapper for the supplied value; never null

Parameters

value

the value to wrap; may be null


fun create(value: Any?, stringRepresentation: String?): ValueWrapper

Factory for creating a new ValueWrapper for the supplied value using the supplied custom stringRepresentation.

You should use this method when you don't want to rely on the result of the value's toString() method.

If the supplied value is null, this method will return a cached ValueWrapper suitable for all null values. If the supplied value is already an instance of ValueWrapper, it will be returned as is if the stringRepresentation match, otherwise the original value will be unwrapped and a new ValueWrapper with the new stringRepresentation will be created.

Return

a wrapper for the supplied value; never null

Since

1.2

Parameters

value

the value to wrap; may be null

stringRepresentation

a custom rendering of the value; will fallback to the default behavior if null