Struct SourceView 

pub struct SourceView<'a> { /* private fields */ }

Bundles source text with its precomputed line-start table. Copy so inner functions can pass it by value without lifetime annotation churn.

Implementations

impl<'a> SourceView<'a>

pub fn source(self) -> &'a str

pub fn position_of(self, offset: u32) -> Position

pub fn positions_of_offsets(self, offsets: &[u32]) -> Vec<Position>

Convert many byte offsets to LSP positions in one pass per touched line.

Calling Self::position_of repeatedly is fine for a handful of spans, but local-variable features can produce hundreds of ranges in one large method. Grouping by line avoids rescanning the same line prefix for every occurrence.

pub fn line_starts(self) -> &'a [u32]

pub fn line_of(self, offset: u32) -> u32

O(log lines) line number for a byte offset. Cheaper than position_of(..).line because it skips the UTF-16 column scan.

pub fn byte_of_position(self, pos: Position) -> u32

O(log lines) UTF-16 Position -> byte offset. Uses the precomputed line_starts table to jump to the target line and only scans that line’s characters. Much faster than a linear scan over the whole source when the cursor is late in the file.

pub fn range_of(self, span: Span) -> Range

pub fn name_range(self, name: &str) -> Range

pub fn name_range_in_span(self, name: &str, span: Span) -> Range

Like name_range, but searches for name within span instead of the whole source. Needed when the same name appears in earlier docblock comments / other declarations — a global search would otherwise point at the first textual occurrence, not the AST node the caller actually meant.

When name cannot be located anywhere (e.g. a synthetic Ident::ERROR placeholder such as "<error>", which never occurs in real source), falls back to an empty range at span.start — guaranteed to be contained in the caller’s span, unlike byte offset 0.

pub fn name_range_after_attrs( self, name: &str, attributes: &[Attribute<'_, '_>], span: Span, ) -> Range

Like [name_range_in_span], but excludes any leading #[...] attribute groups from the search span first.

php-rs-parser captures a member’s span starting at its first attribute token, not at the declaration keyword/name — so searching the raw span can match name as a substring inside an attribute argument (e.g. a method named index matching 'blog_index' in #[Route(name: 'blog_index')]) instead of the actual identifier.

Trait Implementations

impl<'a> Clone for SourceView<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SourceView<'a>