Struct SourceMap 

pub struct SourceMap { /* private fields */ }

The compiler’s registry of source files.

Interning is append-only: once a file has an id its text and path are fixed for the lifetime of the map, which keeps diagnostics and snapshots stable. The map is internally synchronized so it can be shared across threads (the LSP, for example, reads source from a background query thread).

Implementations

impl SourceMap

pub fn new() -> SourceMap

Create an empty source map.

pub fn intern( &self, path: impl Into<PathBuf>, text: impl Into<String>, ) -> FileId

Intern a source file under the given path, returning its id.

Each call mints a fresh id even for a repeated path: a later load of the same path is treated as a distinct snapshot. This matches the §13.1 “revisioned source” model — the LSP holds several revisions of one file simultaneously.

pub fn len(&self) -> usize

The number of interned files.

pub fn is_empty(&self) -> bool

True if no files have been interned.

pub fn get(&self, id: FileId) -> Option<FileView>

Fetch a file by id. Returns None for unknown or synthetic ids.

The returned view shares ownership of the file, so it stays valid across later intern calls (which reallocate the Vec) and across threads.

Trait Implementations

impl Default for SourceMap

fn default() -> SourceMap

Returns the “default value” for a type.