Skip to main content

Concat

Struct Concat 

Source
pub struct Concat<A, B>(pub A, pub B);
Expand description

A Writeable that efficiently concatenates two other Writeables.

See the concat_writeable! macro for a convenient way to make one of these.

§Examples

use writeable::adapters::Concat;
use writeable::assert_writeable_eq;

assert_writeable_eq!(Concat("Number: ", 25), "Number: 25");

With TryWriteable:

use writeable::adapters::Concat;
use writeable::assert_try_writeable_eq;
use writeable::TryWriteable;

struct AlwaysPanic;

impl TryWriteable for AlwaysPanic {
    type Error = &'static str;
    fn try_write_to_parts<W: writeable::PartsWrite + ?Sized>(
        &self,
        _sink: &mut W,
    ) -> Result<Result<(), Self::Error>, core::fmt::Error> {
        // Unreachable panic: the first Writeable errors,
        // so the second Writeable is not evaluated.
        panic!("this is a test to demonstrate unreachable code")
    }
}

let writeable0: Result<&str, &str> = Err("error message");
let writeable1 = AlwaysPanic;

assert_try_writeable_eq!(
    Concat(writeable0, writeable1),
    "error message",
    Err("error message"),
)

Tuple Fields§

§0: A§1: B

Trait Implementations§

Source§

impl<A: Debug, B: Debug> Debug for Concat<A, B>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<A, B> Display for Concat<A, B>
where A: Writeable, B: Writeable,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<A, B, E> TryWriteable for Concat<A, B>
where A: TryWriteable<Error = E>, B: TryWriteable<Error = E>,

Source§

type Error = E

The error type
Source§

fn try_write_to<W: Write + ?Sized>( &self, sink: &mut W, ) -> Result<Result<(), Self::Error>, Error>

Writes the content of this writeable to a sink. Read more
Source§

fn try_write_to_parts<S: PartsWrite + ?Sized>( &self, sink: &mut S, ) -> Result<Result<(), Self::Error>, Error>

Writes the content of this writeable to a sink with parts (annotations). Read more
Source§

fn writeable_length_hint(&self) -> LengthHint

Returns a hint for the number of UTF-8 bytes that will be written to the sink. Read more
Source§

impl<A, B> Writeable for Concat<A, B>
where A: Writeable, B: Writeable,

Source§

fn write_to<W: Write + ?Sized>(&self, sink: &mut W) -> Result

Writes a string to the given sink. Errors from the sink are bubbled up. The default implementation delegates to write_to_parts, and discards any Part annotations.
Source§

fn write_to_parts<S: PartsWrite + ?Sized>(&self, sink: &mut S) -> Result

Write bytes and Part annotations to the given sink. Errors from the sink are bubbled up. The default implementation delegates to write_to, and doesn’t produce any Part annotations.
Source§

fn writeable_length_hint(&self) -> LengthHint

Returns a hint for the number of UTF-8 bytes that will be written to the sink. Read more
Source§

fn writeable_borrow(&self) -> Option<&str>

Returns a &str that matches the output of write_to, if possible. Read more

Auto Trait Implementations§

§

impl<A, B> Freeze for Concat<A, B>
where A: Freeze, B: Freeze,

§

impl<A, B> RefUnwindSafe for Concat<A, B>

§

impl<A, B> Send for Concat<A, B>
where A: Send, B: Send,

§

impl<A, B> Sync for Concat<A, B>
where A: Sync, B: Sync,

§

impl<A, B> Unpin for Concat<A, B>
where A: Unpin, B: Unpin,

§

impl<A, B> UnsafeUnpin for Concat<A, B>
where A: UnsafeUnpin, B: UnsafeUnpin,

§

impl<A, B> UnwindSafe for Concat<A, B>
where A: UnwindSafe, B: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.