Struct Namespace 

pub struct Namespace {
    pub symbols: Vec<(SmolStr, SymbolKind)>,
    pub children: Vec<(SmolStr, Self)>,
    pub file: SmolStr,
    pub import_path: SmolStr,
}

Fields

symbols: Vec<(SmolStr, SymbolKind)>

children: Vec<(SmolStr, Self)>

file: SmolStr

For a module bound by an import, the file it was read from, which is what makes two bindings of one name the same module or two different ones. Empty for a file’s own scope and a host block.

import_path: SmolStr

For a module bound by an import, its path as the import wrote it (std/json, ./geometry.cdl), for a message to name it by.

Implementations

impl Namespace

pub fn fns(&self) -> impl Iterator<Item = &(SmolStr, SymbolKind)>

pub fn structs(&self) -> impl Iterator<Item = &(SmolStr, SymbolKind)>

pub fn find_function( &self, path: &[SmolStr], function_name: &str, ) -> Option<usize>

Resolves a function id by name (with an optional module path). Returns None both when path names no namespace and when the namespace it names declares no such function; raising is left to the caller, which is the only place that knows whether another resolution can still match. A call into a host or dylib namespace is one that can: those functions are declared in State::dyn_libs and never appear in this tree.

pub fn find_struct( &self, path: &[SmolStr], struct_name: &str, span: Span, file_idx: u16, sources: &[Source], ) -> Option<usize>

pub fn find_enum(&self, path: &[SmolStr], enum_name: &str) -> Option<usize>

Resolves an enum type id by name (with an optional module path). Returns None when no enum by that name exists in the resolved namespace; never raises a compile error itself so it can be used for speculative enum-variant resolution against otherwise-unknown call/reference paths.

pub fn find_template(&self, path: &[SmolStr], type_name: &str) -> Option<usize>

Resolves a generic declaration by name (with an optional module path) to its index in Generics::templates. Returns None when the path names no namespace or the namespace it names declares no generic type by that name; the caller decides whether another resolution can still match.

pub fn resolve(&self, path: &[SmolStr]) -> Option<&Self>

The namespace path names, or None when any segment of it is not declared. Resolution alone is not an error: a path can also name a host or dylib namespace, which lives in State::dyn_libs.

pub fn walk_to_namespace( &self, path: &[SmolStr], span: Span, file_idx: u16, sources: &[Source], ) -> &Self

The namespace path names, for a caller that has nowhere else to look: an unresolvable path ends the compile with the unknown-namespace error.

Trait Implementations

impl Clone for Namespace

fn clone(&self) -> Namespace

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Namespace

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

Formats the value using the given formatter.

impl Default for Namespace

fn default() -> Namespace

Returns the “default value” for a type.