Struct EquivalenceMapper

Source

pub struct EquivalenceMapper { /* private fields */ }

Expand description

Equivalence mapper for semantic synonym mapping

Maps field values to their canonical forms based on field-specific equivalence rules. This enables recognition of synonyms like “admin” → “administrator” or “yes” → “1”.

Implementations§

Source §

impl EquivalenceMapper

Source

pub fn new() -> Self

Creates a new empty equivalence mapper

Source

pub fn with_defaults() -> Self

Creates a mapper with default boolean equivalences

Provides common boolean synonym mappings that can be applied to any field by calling apply_default_bool_mappings(fid).

Source

pub fn add_mapping(&mut self, fid: FieldId, from: String, to: String)

Adds a custom mapping for a specific field

§Arguments

fid - The field ID to add the mapping for
from - The source value to map from
to - The canonical value to map to

§Examples

use lnmp_codec::EquivalenceMapper;

let mut mapper = EquivalenceMapper::new();
mapper.add_mapping(12, "admin".to_string(), "administrator".to_string());
mapper.add_mapping(12, "dev".to_string(), "developer".to_string());

assert_eq!(mapper.map(12, "admin"), Some("administrator".to_string()));
assert_eq!(mapper.map(12, "dev"), Some("developer".to_string()));

Source

pub fn add_mappings(&mut self, fid: FieldId, mappings: I)
where I: IntoIterator<Item = (String, String)>,

Adds multiple mappings for a specific field

§Arguments

fid - The field ID to add mappings for
mappings - Iterator of (from, to) value pairs

Source

pub fn apply_default_bool_mappings(&mut self, fid: FieldId)

Applies default boolean equivalence mappings to a field

Maps common boolean representations to “1” (true) or “0” (false):

“yes”, “true” → “1”
“no”, “false” → “0”

§Examples

use lnmp_codec::EquivalenceMapper;

let mut mapper = EquivalenceMapper::new();
mapper.apply_default_bool_mappings(7);

assert_eq!(mapper.map(7, "yes"), Some("1".to_string()));
assert_eq!(mapper.map(7, "true"), Some("1".to_string()));
assert_eq!(mapper.map(7, "no"), Some("0".to_string()));
assert_eq!(mapper.map(7, "false"), Some("0".to_string()));

Source

pub fn map(&self, fid: FieldId, value: &str) -> Option<String>

Maps a value to its canonical form for a specific field

Returns Some(canonical_value) if a mapping exists, or None if the value has no mapping for this field.

§Arguments

fid - The field ID to look up mappings for
value - The value to map

§Examples

use lnmp_codec::EquivalenceMapper;

let mut mapper = EquivalenceMapper::new();
mapper.add_mapping(12, "admin".to_string(), "administrator".to_string());

assert_eq!(mapper.map(12, "admin"), Some("administrator".to_string()));
assert_eq!(mapper.map(12, "user"), None);
assert_eq!(mapper.map(99, "admin"), None); // Different field