[−][src]Struct rmpv::Utf8String
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.
Methods
impl Utf8String
[src]
impl Utf8String
pub fn is_str(&self) -> bool
[src]
pub fn is_str(&self) -> bool
Returns true
if the string is valid UTF-8.
pub fn is_err(&self) -> bool
[src]
pub fn is_err(&self) -> bool
Returns true
if the string contains invalid UTF-8 sequence.
pub fn as_str(&self) -> Option<&str>
[src]
pub fn as_str(&self) -> Option<&str>
Returns the string reference if the string is valid UTF-8, or else None
.
pub fn as_err(&self) -> Option<&Utf8Error>
[src]
pub fn as_err(&self) -> Option<&Utf8Error>
Returns the underlying Utf8Error
if the string contains invalud UTF-8 sequence, or
else None
.
pub fn as_bytes(&self) -> &[u8]
[src]
pub fn as_bytes(&self) -> &[u8]
Returns a byte slice of this Utf8String
's contents.
pub fn into_str(self) -> Option<String>
[src]
pub fn into_str(self) -> Option<String>
Consumes this object, yielding the string if the string is valid UTF-8, or else None
.
pub fn into_bytes(self) -> Vec<u8>
[src]
pub fn into_bytes(self) -> Vec<u8>
Converts a Utf8String
into a byte vector.
Trait Implementations
impl<'a> Into<Utf8String> for Utf8StringRef<'a>
[src]
impl<'a> Into<Utf8String> for Utf8StringRef<'a>
fn into(self) -> Utf8String
[src]
fn into(self) -> Utf8String
Performs the conversion.
impl PartialEq<Utf8String> for Utf8String
[src]
impl PartialEq<Utf8String> for Utf8String
fn eq(&self, other: &Utf8String) -> bool
[src]
fn eq(&self, other: &Utf8String) -> bool
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, other: &Utf8String) -> bool
[src]
fn ne(&self, other: &Utf8String) -> bool
This method tests for !=
.
impl<'a> From<String> for Utf8String
[src]
impl<'a> From<String> for Utf8String
impl<'a> From<&'a str> for Utf8String
[src]
impl<'a> From<&'a str> for Utf8String
impl<'a> From<Cow<'a, str>> for Utf8String
[src]
impl<'a> From<Cow<'a, str>> for Utf8String
impl Clone for Utf8String
[src]
impl Clone for Utf8String
fn clone(&self) -> Utf8String
[src]
fn clone(&self) -> Utf8String
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from source
. Read more
impl Display for Utf8String
[src]
impl Display for Utf8String
fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>
[src]
fn fmt(&self, fmt: &mut Formatter) -> Result<(), Error>
Formats the value using the given formatter. Read more
impl Debug for Utf8String
[src]
impl Debug for Utf8String
Auto Trait Implementations
impl Send for Utf8String
impl Send for Utf8String
impl Sync for Utf8String
impl Sync for Utf8String
Blanket Implementations
impl<T, U> Into for T where
U: From<T>,
[src]
impl<T, U> Into for T where
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
type Owned = T
fn to_owned(&self) -> T
[src]
fn to_owned(&self) -> T
Creates owned data from borrowed data, usually by cloning. Read more
fn clone_into(&self, target: &mut T)
[src]
fn clone_into(&self, target: &mut T)
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
impl<T> ToString for T where
T: Display + ?Sized,
[src]
impl<T> ToString for T where
T: Display + ?Sized,
impl<T> From for T
[src]
impl<T> From for T
impl<T, U> TryFrom for T where
T: From<U>,
[src]
impl<T, U> TryFrom for T where
T: From<U>,
type Error = !
try_from
)The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
try_from
)Performs the conversion.
impl<T> Borrow for T where
T: ?Sized,
[src]
impl<T> Borrow for T where
T: ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
impl<T> BorrowMut for T where
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
try_from
)The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
try_from
)Performs the conversion.
impl<T> Any for T where
T: 'static + ?Sized,
[src]
impl<T> Any for T where
T: 'static + ?Sized,
fn get_type_id(&self) -> TypeId
[src]
fn get_type_id(&self) -> TypeId
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static
Gets the TypeId
of self
. Read more