pub struct Utf8String { /* fields omitted */ }
Represents an UTF-8 MessagePack string type.
According to the MessagePack spec, string objects may contain invalid byte sequence and the
behavior of a deserializer depends on the actual implementation when it received invalid byte
sequence.
Deserializers should provide functionality to get the original byte array so that applications
can decide how to handle the object.
Summarizing, it's prohibited to instantiate a string type with invalid UTF-8 sequences, however
it is possible to obtain an underlying bytes that were attempted to convert to a String
. This
may happen when trying to unpack strings that were decoded using older MessagePack spec with
raw types instead of string/binary.
Returns true
if the string is valid UTF-8.
Returns true
if the string contains invalid UTF-8 sequence.
Returns the string reference if the string is valid UTF-8, or else None
.
Returns the underlying Utf8Error
if the string contains invalud UTF-8 sequence, or
else None
.
Returns a byte slice of this Utf8String
's contents.
Consumes this object, yielding the string if the string is valid UTF-8, or else None
.
Converts a Utf8String
into a byte vector.
Performs copy-assignment from source
. Read more
This method tests for self
and other
values to be equal, and is used by ==
. Read more
This method tests for !=
.
Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String
. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Mutably borrows from an owned value. Read more