Struct OrphanedNamespaceScopeIndex 

pub struct OrphanedNamespaceScopeIndex { /* private fields */ }

The namespaces C++ parse recovery drops from a file’s tree.

When tree-sitter cannot parse a construct inside a namespace body it closes an inner scope with a MISSING brace, or skips an opening brace into an ERROR node. Every real } after that then closes one scope too early: a class body’s } closes the namespace, the namespace’s own } closes its parent, and the outermost real closes land in a trailing ERROR node. The declarations between a stolen close and the real one keep their byte positions but lose their namespace_definition ancestors (Catch2’s catch_matchers_templated.hpp, issue #1537).

Braces balance in source that compiles, so the lost scopes are exactly what a brace stack over tree-sitter’s own tokens leaves open. Within one node, in child order: a real { opens a scope (the node’s namespace when the node is a named namespace body, otherwise an opaque scope); a real } closes the innermost open scope, or is owed to the parent when the node has none open; a MISSING brace is not a token and does nothing; a child without errors is balanced and contributes nothing; an error-marked child contributes the closes it owes and the scopes it leaves open. Whatever is open before a child starts, beyond the node’s own scope, is what the parse lost for that child. Consecutive children with the same lost namespaces form one RecoveredNamespaceRegion. A file without parse errors has no regions.

Implementations

impl OrphanedNamespaceScopeIndex

pub fn build(root: Node<'_>, source: &str) -> Self

pub fn is_empty(&self) -> bool

pub fn approximate_size(&self) -> usize

The bytes this index holds, for the analyzer cache’s weight.

pub fn region_at(&self, byte: usize) -> Option<&RecoveredNamespaceRegion>

The innermost recovered region containing byte.

pub fn enclosing_namespace_components( &self, node: Node<'_>, source: &str, ) -> Vec<String>

The enclosing namespaces of node, outermost first, restoring the ones parse recovery dropped from its ancestor chain. The one answer both lookup directions and declaration collection use (issue #1537).

pub fn restore_enclosing_namespaces( &self, parsed: Vec<(usize, Vec<String>)>, node_start: usize, ) -> Vec<String>

Self::enclosing_namespace_components for a caller that has already climbed the ancestor chain: parsed lists the node’s named namespace_definition ancestors outermost first, each with its start byte. A region covering the node supplies every namespace outside it; only the parsed ancestors that start inside the region still apply.

Trait Implementations

impl Clone for OrphanedNamespaceScopeIndex

fn clone(&self) -> OrphanedNamespaceScopeIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OrphanedNamespaceScopeIndex

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

Formats the value using the given formatter.

impl Default for OrphanedNamespaceScopeIndex

fn default() -> OrphanedNamespaceScopeIndex

Returns the “default value” for a type.