Struct SourceMap 

pub struct SourceMap { /* private fields */ }

Collects immutable source owners in insertion order without filesystem IO.

Locations retain their own owners; dropping this collection does not invalidate them. See the module example.

Implementations

impl SourceMap

pub fn new() -> Self

Creates an empty source collection.

Examples

assert!(adam_lang::SourceMap::new().sources().is_empty());

pub fn insert(&mut self, file_name: &str, text: &str) -> SourceId

Copies a file name and source text into a new immutable source owner.

Repeated insertions create distinct identities.

• Complexity: O(f + t) time and space for file name length f and text length t, plus amortized O(1) collection insertion.

Examples

See the module example.

pub fn get(&self, source: &SourceId) -> Option<&SourceId>

Returns the retained owner only if this collection contains source.

Coincident indices in independent collections do not match.

Examples

let mut map = adam_lang::SourceMap::new();
let id = map.insert("file.adm2", "");
assert_eq!(map.get(&id), Some(&id));
assert!(adam_lang::SourceMap::new().get(&id).is_none());

pub fn sources(&self) -> &[SourceId]

Borrows source owners in insertion order.

Examples

See Self::new.

Trait Implementations

impl Debug for SourceMap

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

Formats the value using the given formatter.

impl Default for SourceMap

fn default() -> Self

Returns the “default value” for a type.