Struct bdk_chain::bitcoin::base64::write::EncoderStringWriter
pub struct EncoderStringWriter<'e, E, S>where
E: Engine,
S: StrConsumer,{ /* private fields */ }
Expand description
A Write
implementation that base64-encodes data using the provided config and accumulates the
resulting base64 utf8 &str
in a StrConsumer implementation (typically String
), which is
then exposed via into_inner()
.
§Examples
Buffer base64 in a new String:
use std::io::Write;
use base64::engine::general_purpose;
let mut enc = base64::write::EncoderStringWriter::new(&general_purpose::STANDARD);
enc.write_all(b"asdf").unwrap();
// get the resulting String
let b64_string = enc.into_inner();
assert_eq!("YXNkZg==", &b64_string);
Or, append to an existing String
, which implements StrConsumer
:
use std::io::Write;
use base64::engine::general_purpose;
let mut buf = String::from("base64: ");
let mut enc = base64::write::EncoderStringWriter::from_consumer(
&mut buf,
&general_purpose::STANDARD);
enc.write_all(b"asdf").unwrap();
// release the &mut reference on buf
let _ = enc.into_inner();
assert_eq!("base64: YXNkZg==", &buf);
§Performance
Because it has to validate that the base64 is UTF-8, it is about 80% as fast as writing plain
bytes to a io::Write
.
Implementations§
§impl<'e, E, S> EncoderStringWriter<'e, E, S>where
E: Engine,
S: StrConsumer,
impl<'e, E, S> EncoderStringWriter<'e, E, S>where
E: Engine,
S: StrConsumer,
pub fn from_consumer(
str_consumer: S,
engine: &'e E
) -> EncoderStringWriter<'e, E, S> ⓘ
pub fn from_consumer( str_consumer: S, engine: &'e E ) -> EncoderStringWriter<'e, E, S> ⓘ
Create a EncoderStringWriter that will append to the provided StrConsumer
.
pub fn into_inner(self) -> S
pub fn into_inner(self) -> S
Encode all remaining buffered data, including any trailing incomplete input triples and associated padding.
Returns the base64-encoded form of the accumulated written data.
§impl<'e, E> EncoderStringWriter<'e, E, String>where
E: Engine,
impl<'e, E> EncoderStringWriter<'e, E, String>where
E: Engine,
pub fn new(engine: &'e E) -> EncoderStringWriter<'e, E, String> ⓘ
pub fn new(engine: &'e E) -> EncoderStringWriter<'e, E, String> ⓘ
Create a EncoderStringWriter that will encode into a new String
with the provided config.
Trait Implementations§
§impl<'e, E, S> Write for EncoderStringWriter<'e, E, S>where
E: Engine,
S: StrConsumer,
impl<'e, E, S> Write for EncoderStringWriter<'e, E, S>where
E: Engine,
S: StrConsumer,
§fn write(&mut self, buf: &[u8]) -> Result<usize, Error>
fn write(&mut self, buf: &[u8]) -> Result<usize, Error>
§fn flush(&mut self) -> Result<(), Error>
fn flush(&mut self) -> Result<(), Error>
source§fn is_write_vectored(&self) -> bool
fn is_write_vectored(&self) -> bool
can_vector
)1.0.0 · source§fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>
source§fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>
write_all_vectored
)