Struct NameMap

pub struct NameMap<K: Clone + Hash + Eq + Ord, V> { /* private fields */ }

A semver-aware map for imports/exports of a component.

This data structure is used when looking up the names of imports/exports of a component to enable semver-compatible matching of lookups. This will enable lookups of a:b/c@0.2.0 to match entries defined as a:b/c@0.2.1 which is currently considered a key feature of WASI’s compatibility story.

On the outside this looks like a map of K to V.

Implementations

impl<K, V> NameMap<K, V>

where K: Clone + Hash + Eq + Ord,

pub fn insert<I>( &mut self, name: &str, cx: &mut I, allow_shadowing: bool, item: V, ) -> Result<K>

where I: NameMapIntern<Key = K>,

Inserts the name specified into this map.

The name is intern’d through the cx argument and shadowing is controlled by the allow_shadowing variable.

This function will automatically insert an entry in self.alternate_lookups if name is a semver-looking name.

Returns an error if allow_shadowing is false and the name is already present in this map (by exact match). Otherwise returns the intern’d version of name.

pub fn get<I>(&self, name: &str, cx: &I) -> Option<&V>

where I: NameMapIntern<Key = K>,

Looks up name within this map, using the interning specified by cx.

This may return a definition even if name wasn’t exactly defined in this map, such as looking up a:b/c@0.2.0 when the map only has a:b/c@0.2.1 defined.

pub fn raw_iter(&self) -> impl Iterator<Item = (&K, &V)>

Returns an iterator over inserted values in this map.

Note that the iterator return yields intern’d keys and additionally does not do anything special with semver names and such, it only literally yields what’s been inserted with NameMap::insert.

pub fn raw_get_mut(&mut self, key: &K) -> Option<&mut V>

TODO

Trait Implementations

impl<K: Clone + Clone + Hash + Eq + Ord, V: Clone> Clone for NameMap<K, V>

fn clone(&self) -> NameMap<K, V>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<K: Debug + Clone + Hash + Eq + Ord, V: Debug> Debug for NameMap<K, V>

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

Formats the value using the given formatter.

impl<K, V> Default for NameMap<K, V>

where K: Clone + Hash + Eq + Ord,

fn default() -> NameMap<K, V>

Returns the “default value” for a type.

impl<'de, K, V> Deserialize<'de> for NameMap<K, V>

where K: Deserialize<'de> + Clone + Hash + Eq + Ord, V: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<K, V> Serialize for NameMap<K, V>

where K: Serialize + Clone + Hash + Eq + Ord, V: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.