Struct aws_smithy_eventstream::str_bytes::StrBytes

#[non_exhaustive]
pub struct StrBytes { /* private fields */ }

UTF-8 string byte buffer representation with validation amortization. When StrBytes is constructed from a &str or String, its underlying bytes are assumed to be valid UTF-8. Otherwise, if constructed from a byte source, the construction will be fallible.

Example construction from a &str:

use aws_smithy_eventstream::str_bytes::StrBytes;

let value: StrBytes = "example".into();
assert_eq!("example", value.as_str());
assert_eq!(b"example", &value.as_bytes()[..]);

Example construction from Bytes:

use bytes::Bytes;
use aws_smithy_eventstream::str_bytes::StrBytes;
use std::convert::TryInto;

let bytes = Bytes::from_static(b"example");
let value: StrBytes = bytes.try_into().expect("valid utf-8");
assert_eq!("example", value.as_str());
assert_eq!(b"example", &value.as_bytes()[..]);

Implementations

impl StrBytes

pub fn as_bytes(&self) -> &Bytes

Returns the underlying Bytes representation.

pub fn as_str(&self) -> &str

Returns the StrBytes value as a &str.

pub fn try_copy_from_slice(slice: &[u8]) -> Result<Self, Utf8Error>

Tries to create a StrBytes from a slice, or returns a Utf8Error if the slice is not valid UTF-8.

pub fn copy_from_str(string: &str) -> Self

Creates a StrBytes from a &str.

Trait Implementations

impl<'a> Arbitrary<'a> for StrBytes

fn arbitrary(unstruct: &mut Unstructured<'a>) -> Result<Self>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for StrBytes

fn clone(&self) -> StrBytes

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for StrBytes

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<&'static str> for StrBytes

fn from(value: &'static str) -> Self

Converts to this type from the input type.

impl From<String> for StrBytes

fn from(value: String) -> Self

Converts to this type from the input type.

impl PartialEq<StrBytes> for StrBytes

fn eq(&self, other: &StrBytes) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<&'static [u8]> for StrBytes

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(value: &'static [u8]) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Bytes> for StrBytes

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(bytes: Bytes) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Vec<u8, Global>> for StrBytes

type Error = Utf8Error

The type returned in the event of a conversion error.

fn try_from(value: Vec<u8>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for StrBytes

impl StructuralEq for StrBytes

impl StructuralPartialEq for StrBytes