Struct serde_with::BytesOrString [−][src]
pub struct BytesOrString;
Deserialize from bytes or string
Any Rust String
can be converted into bytes, i.e., Vec<u8>
.
Accepting both as formats while deserializing can be helpful while interacting with language
which have a looser definition of string than Rust.
Example
#[serde_as] #[derive(Deserialize, Serialize)] struct A { #[serde_as(as = "BytesOrString")] bytes_or_string: Vec<u8>, } // Here we deserialize from a byte array ... let j = json!({ "bytes_or_string": [ 0, 1, 2, 3 ] }); let a: A = serde_json::from_value(j.clone()).unwrap(); assert_eq!(vec![0, 1, 2, 3], a.bytes_or_string); // and serialization works too. assert_eq!(j, serde_json::to_value(&a).unwrap()); // But we also support deserializing from a String let j = json!({ "bytes_or_string": "✨Works!" }); let a: A = serde_json::from_value(j).unwrap(); assert_eq!("✨Works!".as_bytes(), &*a.bytes_or_string);
Trait Implementations
impl Clone for BytesOrString
[src]
impl Clone for BytesOrString
[src]fn clone(&self) -> BytesOrString
[src]
fn clone(&self) -> BytesOrString
[src]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)
1.0.0[src]Performs copy-assignment from source
. Read more
impl Debug for BytesOrString
[src]
impl Debug for BytesOrString
[src]impl Default for BytesOrString
[src]
impl Default for BytesOrString
[src]fn default() -> BytesOrString
[src]
fn default() -> BytesOrString
[src]Returns the “default value” for a type. Read more
impl<'de> DeserializeAs<'de, Vec<u8, Global>> for BytesOrString
[src]
impl<'de> DeserializeAs<'de, Vec<u8, Global>> for BytesOrString
[src]fn deserialize_as<D>(deserializer: D) -> Result<Vec<u8>, D::Error> where
D: Deserializer<'de>,
[src]
fn deserialize_as<D>(deserializer: D) -> Result<Vec<u8>, D::Error> where
D: Deserializer<'de>,
[src]Deserialize this value from the given Serde deserializer.
impl SerializeAs<Vec<u8, Global>> for BytesOrString
[src]
impl SerializeAs<Vec<u8, Global>> for BytesOrString
[src]fn serialize_as<S>(source: &Vec<u8>, serializer: S) -> Result<S::Ok, S::Error> where
S: Serializer,
[src]
fn serialize_as<S>(source: &Vec<u8>, serializer: S) -> Result<S::Ok, S::Error> where
S: Serializer,
[src]Serialize this value into the given Serde serializer.
impl Copy for BytesOrString
[src]
Auto Trait Implementations
impl RefUnwindSafe for BytesOrString
impl Send for BytesOrString
impl Sync for BytesOrString
impl Unpin for BytesOrString
impl UnwindSafe for BytesOrString
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more