Struct Position 

#[non_exhaustive]
pub struct Position {
    pub line: u32,
    pub column: u32,
    pub file: Option<Arc<Vec<String>>>,
}

A Position represents a human-readable position in a document — one ASG locationBoundary. For byte offsets, use Location.absolute_start / Location.absolute_end.

Equality and hashing cover all three fields, file included: two positions at the same line/column but reached through different include:: chains — or one from the primary input (file: None) versus one from an included file — are not equal. This is deliberate: a line/column is only a unique location together with its file.

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.

line: u32

The line number of the position (1-indexed).

column: u32

The column number of the position (1-indexed, counted as Unicode scalar values).

file: Option<Arc<Vec<String>>>

The include:: chain this position’s content came through, outermost target first and the file directly containing the content last — each element the include target as written in its directive (e.g. ["a.adoc", "b.adoc"] for content in b.adoc included by a.adoc). None for content from the primary input, which the ASG omits. Shared (Arc) across all positions reached through the same chain, so the field stays a thin 8-byte pointer.

Implementations

impl Position

pub fn new(line: u32, column: u32) -> Self

A position at line/column with no originating file (primary input).

pub fn from_line_col(line: usize, column: usize) -> Self

A position from usize line/column, saturating at u32::MAX (neither can realistically exceed it). For callers that already hold u32 — the hot parse and diagnostic paths — prefer the lossless new. The named arguments here guard against accidentally transposing line and column at the many usize-scanning call sites (preprocessor line counters, byte indices).

Trait Implementations

impl Clone for Position

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Position

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

Formats the value using the given formatter.

impl Default for Position

fn default() -> Self

Returns the “default value” for a type.

impl Display for Position

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

Formats the value using the given formatter.

impl Eq for Position

impl Hash for Position

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 Position

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Position

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Position