Nickname registration and lookup

Register and look up nickname mappings.

Usage

nn_register(mappings, dict = "default")

nn(x, dict = "default")

# Default S3 method
nn(x, dict = "default")

# S3 method for class 'data.frame'
nn(x, dict = "default")

Arguments

mappings

A named vector where names are original values and values are nicknames

dict

The dictionary name to use (defaults to "default").

x

The value to look up, this can be a dataframe or character vector.

Value

nn_register() returns nothing. nn() returns the nickname if one is registered, otherwise the original value.

Examples

# Register some nickname mappings
nn_register(c(
  "Jennifer" = "Jen",
  "Robert" = "Bob",
  "Elizabeth" = "Liz"
))

# Look up nicknames
nn("Jennifer")  # Returns "Jen"
#> [1] "Jen"
nn("Robert")    # Returns "Bob"
#> [1] "Bob"
nn("John")      # Returns "John" (no mapping registered)
#> [1] "John"

# Use different dictionaries
nn_register(c("Jennifer" = "Jenny"), dict = "alt")
nn("Jennifer")              # Returns "Jen" (from default dict)
#> [1] "Jen"
nn("Jennifer", dict = "alt") # Returns "Jenny" (from alt dict)
#> [1] "Jenny"