Struct RopeBuilder

pub struct RopeBuilder { /* private fields */ }

RopeBuilder provides a mutable container to append bytes/strings. This can also append other Rope instances cheaply, allowing efficient sharing of the contents without a full clone of the bytes.

Implementations

impl RopeBuilder

pub fn push_bytes(&mut self, bytes: &[u8])

Push owned bytes into the Rope.

If possible use [push_static_bytes] or += operation instead, as they will create a reference to shared memory instead of cloning the bytes.

pub fn push_static_bytes(&mut self, bytes: &'static [u8])

Push static lifetime bytes into the Rope.

This is more efficient than pushing owned bytes, because the internal data does not need to be copied when the rope is read.

pub fn concat(&mut self, other: &Rope)

Concatenate another Rope instance into our builder.

This is much more efficient than pushing actual bytes, since we can share the other Rope’s references without copying the underlying data.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn build(self) -> Rope

Constructs our final, immutable Rope instance.

Trait Implementations

impl AddAssign<&Rope> for RopeBuilder

fn add_assign(&mut self, rhs: &Rope)

Performs the += operation.

impl AddAssign<&'static str> for RopeBuilder

fn add_assign(&mut self, rhs: &'static str)

Pushes a reference to static memory onto the rope.

This is more efficient than pushing owned bytes, because the internal data does not need to be copied when the rope is read.

impl Debug for RopeBuilder

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

Formats the value using the given formatter.

impl Default for RopeBuilder

fn default() -> RopeBuilder

Returns the “default value” for a type.

impl From<&'static str> for RopeBuilder

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

Converts to this type from the input type.

impl From<Vec<u8>> for RopeBuilder

fn from(bytes: Vec<u8>) -> Self

Converts to this type from the input type.

impl Write for RopeBuilder

fn write(&mut self, bytes: &[u8]) -> IoResult<usize>

Writes a buffer into this writer, returning how many bytes were written.

fn flush(&mut self) -> IoResult<()>

Flushes this output stream, ensuring that all intermediately buffered contents reach their destination.

fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

fn is_write_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Writer has an efficient write_vectored implementation.

fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

fn write_all_vectored(&mut self, bufs: &mut [IoSlice<'_>]) -> Result<(), Error>

🔬This is a nightly-only experimental API. (write_all_vectored)

Attempts to write multiple buffers into this writer.

fn write_fmt(&mut self, args: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.