Struct Namer

pub struct Namer {
    unique: FastHashMap<String, u32>,
    keywords: &'static KeywordSet,
    keywords_case_insensitive: &'static CaseInsensitiveKeywordSet,
    reserved_prefixes: Vec<&'static str>,
}

This processor assigns names to all the things in a module that may need identifiers in a textual backend.

Fields

unique: FastHashMap<String, u32>

The last numeric suffix used for each base name. Zero means “no suffix”.

keywords: &'static KeywordSet

keywords_case_insensitive: &'static CaseInsensitiveKeywordSet

reserved_prefixes: Vec<&'static str>

Implementations

impl Namer

fn sanitize<'s>(&self, string: &'s str) -> Cow<'s, str>

Return a form of string suitable for use as the base of an identifier.

• Drop leading digits.
• Retain only alphanumeric and _ characters.
• Avoid prefixes in Namer::reserved_prefixes.
• Replace consecutive _ characters with a single _ character.

The return value is a valid identifier prefix in all of Naga’s output languages, and it never ends with a SEPARATOR character. It is used as a key into the unique table.

pub fn call(&mut self, label_raw: &str) -> String

Return a new identifier based on label_raw.

The result:

• is a valid identifier even if label_raw is not
• conflicts with no keywords listed in Namer::keywords, and
• is different from any identifier previously constructed by this Namer.

Guarantee uniqueness by applying a numeric suffix when necessary. If label_raw itself ends with digits, separate them from the suffix with an underscore.

pub fn call_or(&mut self, label: &Option<String>, fallback: &str) -> String

fn namespace(&mut self, capacity: usize, body: impl FnOnce(&mut Self))

Enter a local namespace for things like structs.

Struct member names only need to be unique amongst themselves, not globally. This function temporarily establishes a fresh, empty naming context for the duration of the call to body.

pub fn reset( &mut self, module: &Module, reserved_keywords: &'static KeywordSet, reserved_keywords_case_insensitive: &'static CaseInsensitiveKeywordSet, reserved_prefixes: &[&'static str], output: &mut FastHashMap<NameKey, String>, )

Trait Implementations

impl Default for Namer

fn default() -> Namer

Returns the “default value” for a type.