Struct TextSize

pub struct TextSize { /* private fields */ }

A measure of text length. Also, equivalently, an index into text.

This is a UTF-8 bytes offset stored as u32, but most clients should treat it as an opaque measure.

For cases that need to escape TextSize and return to working directly with primitive integers, TextSize can be converted losslessly to/from u32 via From conversions as well as losslessly be converted Into usize. The usize -> TextSize direction can be done via TryFrom.

These escape hatches are primarily required for unit testing and when converting from UTF-8 size to another coordinate space, such as UTF-16.

Implementations

impl TextSize

pub const fn new(raw: u32) -> TextSize

Creates a new instance of TextSize from a raw u32.

pub fn of<T>(text: T) -> TextSize

where T: TextLen,

The text size of some primitive text-like object.

Accepts char, &str, and &String.

Examples

let char_size = TextSize::of('🦀');
assert_eq!(char_size, TextSize::from(4));

let str_size = TextSize::of("rust-analyzer");
assert_eq!(str_size, TextSize::from(13));

impl TextSize

Methods to act like a primitive integer type, where reasonably applicable.

pub const fn checked_add(self, rhs: TextSize) -> Option<TextSize>

Checked addition. Returns None if overflow occurred.

pub const fn checked_sub(self, rhs: TextSize) -> Option<TextSize>

Checked subtraction. Returns None if overflow occurred.

Trait Implementations

impl Add<&TextSize> for TextRange

type Output = TextRange

The resulting type after applying the + operator.

fn add(self, other: &TextSize) -> TextRange

Performs the + operation.

impl Add<&TextSize> for TextSize

type Output = TextSize

The resulting type after applying the + operator.

fn add(self, other: &TextSize) -> TextSize

Performs the + operation.

impl<T> Add<T> for &TextSize

where TextSize: Add<T, Output = TextSize>,

type Output = TextSize

The resulting type after applying the + operator.

fn add(self, other: T) -> TextSize

Performs the + operation.

impl Add<TextSize> for TextRange

type Output = TextRange

The resulting type after applying the + operator.

fn add(self, offset: TextSize) -> TextRange

Performs the + operation.

impl Add for TextSize

type Output = TextSize

The resulting type after applying the + operator.

fn add(self, other: TextSize) -> TextSize

Performs the + operation.

impl<A> AddAssign<A> for TextSize

where TextSize: Add<A, Output = TextSize>,

fn add_assign(&mut self, rhs: A)

Performs the += operation.

impl AddAssign<Delta<TextSize>> for TextSize

fn add_assign(&mut self, rhs: Delta<TextSize>)

Performs the += operation.

impl Clone for TextSize

fn clone(&self) -> TextSize

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TextSize

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

Formats the value using the given formatter.

impl Default for TextSize

fn default() -> TextSize

Returns the “default value” for a type.

impl From<u32> for TextSize

fn from(raw: u32) -> TextSize

Converts to this type from the input type.

impl Hash for TextSize

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for TextSize

fn cmp(&self, other: &TextSize) -> 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 TextSize

fn eq(&self, other: &TextSize) -> 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 TextSize

fn partial_cmp(&self, other: &TextSize) -> 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 RangeBounds<TextSize> for TextRange

fn start_bound(&self) -> Bound<&TextSize>

Start index bound.

fn end_bound(&self) -> Bound<&TextSize>

End index bound.

fn contains<U>(&self, item: &U) -> bool

where T: PartialOrd<U>, U: PartialOrd<T> + ?Sized,

Returns true if item is contained in the range.

impl Sub<&TextSize> for TextRange

type Output = TextRange

The resulting type after applying the - operator.

fn sub(self, other: &TextSize) -> TextRange

Performs the - operation.

impl Sub<&TextSize> for TextSize

type Output = TextSize

The resulting type after applying the - operator.

fn sub(self, other: &TextSize) -> TextSize

Performs the - operation.

impl<T> Sub<T> for &TextSize

where TextSize: Sub<T, Output = TextSize>,

type Output = TextSize

The resulting type after applying the - operator.

fn sub(self, other: T) -> TextSize

Performs the - operation.

impl Sub<TextSize> for TextRange

type Output = TextRange

The resulting type after applying the - operator.

fn sub(self, offset: TextSize) -> TextRange

Performs the - operation.

impl Sub for TextSize

type Output = TextSize

The resulting type after applying the - operator.

fn sub(self, other: TextSize) -> TextSize

Performs the - operation.

impl<S> SubAssign<S> for TextSize

where TextSize: Sub<S, Output = TextSize>,

fn sub_assign(&mut self, rhs: S)

Performs the -= operation.

impl<A> Sum<A> for TextSize

where TextSize: Add<A, Output = TextSize>,

fn sum<I>(iter: I) -> TextSize

where I: Iterator<Item = A>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl TryFrom<usize> for TextSize

type Error = TryFromIntError

The type returned in the event of a conversion error.

fn try_from(value: usize) -> Result<TextSize, TryFromIntError>

Performs the conversion.

impl Copy for TextSize

impl Eq for TextSize

impl StructuralPartialEq for TextSize