Struct Rope

pub struct Rope { /* private fields */ }

An efficient structure for sharing bytes/strings between multiple sources.

Cloning a Rope is extremely cheap (Arc and usize), and sharing the contents of one Rope can be done by just cloning an Arc.

Ropes are immutable, in order to construct one see RopeBuilder.

Implementations

impl Rope

pub fn cell(self) -> Vc<Self>

Places a value in a cell of the current task.

Cell is selected based on the value type and call order of cell.

pub fn resolved_cell(self) -> ResolvedVc<Self>

Places a value in a cell of the current task. Returns a [ResolvedVc][turbo_tasks::ResolvedVc].

Cell is selected based on the value type and call order of cell.

impl Rope

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn read(&self) -> RopeReader

Returns a Read/[AsyncRead]/Iterator instance over all bytes.

pub fn to_str(&self) -> Result<Cow<'_, str>>

Returns a String instance of all bytes.

pub fn to_bytes(&self) -> Result<Cow<'_, [u8]>>

Returns a slice of all bytes

Trait Implementations

impl AddAssign<&Rope> for RopeBuilder

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

Performs the += operation.

impl Clone for Rope

fn clone(&self) -> Rope

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Rope

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

Formats the value using the given formatter.

impl Default for Rope

fn default() -> Rope

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Rope

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserializes strings into a contiguous, immutable Rope.

impl DeterministicHash for Rope

fn deterministic_hash<H: DeterministicHasher>(&self, state: &mut H)

Ropes with similar contents hash the same, regardless of their structure.

impl From<Rope> for File

fn from(rope: Rope) -> Self

Converts to this type from the input type.

impl From<Rope> for Vc<Rope>

fn from(value: Rope) -> Self

Converts to this type from the input type.

impl From<String> for Rope

fn from(bytes: String) -> Self

Converts to this type from the input type.

impl<T: Into<Bytes>> From<T> for Rope

default fn from(bytes: T) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for Rope

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

Converts to this type from the input type.

impl Ord for Rope

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Rope

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for Rope

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Rope

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Ropes are always serialized into contiguous strings, because deserialization won’t deduplicate and share the Arcs (being the only possible owner of a individual “shared” data doesn’t make sense).

impl ShrinkToFit for Rope

fn shrink_to_fit(&mut self)

impl TraceRawVcs for Rope

fn trace_raw_vcs(&self, __context__: &mut TraceRawVcsContext)

fn get_raw_vcs(&self) -> Vec<RawVc>

impl ValueDebug for Rope

fn dbg(self: Vc<Self>) -> Vc<ValueDebugString>

fn dbg_depth(self: Vc<Self>, depth: usize) -> Vc<ValueDebugString>

Like dbg, but with a depth limit.

impl ValueDebugFormat for Rope

fn value_debug_format<'a>(&'a self, depth: usize) -> ValueDebugFormatString<'a>

impl VcValueType for Rope

type Read = VcDefaultRead<Rope>

How to read the value.

type CellMode = VcCellSharedMode<Rope>

How to update cells of this value type.

fn get_value_type_id() -> ValueTypeId

Returns the type id of the value type.

impl Eq for Rope

impl NonLocalValue for Rope

impl OperationValue for Rope

impl Upcast<Box<dyn ValueDebug>> for Rope