Struct Location 

#[non_exhaustive]
pub struct Location {
    pub absolute_start: usize,
    pub absolute_end: usize,
    pub start: Position,
    pub end: Position,
}

A Location represents a location in a document.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

absolute_start: usize

The absolute start position of the location.

absolute_end: usize

The absolute end position of the location.

start: Position

The start position of the location.

end: Position

The end position of the location.

Implementations

impl Location

pub fn validate(&self, input: &str) -> Result<(), String>

Validates that this location satisfies all invariants.

Checks:

• absolute_start <= absolute_end (valid range)
• absolute_end <= input.len() (within bounds)
• Both offsets are on UTF-8 character boundaries

Errors

Returned as strings for easier debugging.

pub fn shift(&mut self, parent: Option<&Location>)

Shift the start and end positions of the location by the parent location.

This is super useful to adjust the location of a block that is inside another block, like anything inside a delimiter block.

pub fn shift_inline(&mut self, parent: Option<&Location>)

Shifts the location inline. We subtract 1 from the line number of the start and end to account for the fact that inlines are always in the same line as the parent calling the parsing function.

pub fn shift_line_column(&mut self, line: usize, column: usize)

Trait Implementations

impl Clone for Location

fn clone(&self) -> Location

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Location

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

Formats the value using the given formatter.

impl Default for Location

fn default() -> Location

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Location

fn deserialize<D>(deserializer: D) -> Result<Location, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Location

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

Formats the value using the given formatter.

impl Hash for Location

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

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 PartialEq for Location

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

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Location

impl StructuralPartialEq for Location