Skip to contents

SDTM term to code

Source: R/code-to-term.R
term_to_code.Rd

term_to_code() maps SDTM terminology terms to respective C-codes. For mapping terms referring to codelists, use clst_term_to_code() instead.

Usage

term_to_code(term, clst_code)

Arguments

term

A SDTM controlled terminology term (as expected in submissions).

clst_code

Parent codelist code.

Value

A character vector of SDTM controlled terminology C-codes. The number of elements returned matches the number of elements in term, i.e. there is a one-to-one correspondence between input and output. Invalid codes in term are mapped to NA.

See also

See code_to_term() for the inverse operation.

Examples

term_to_code(term = "TENMW101", clst_code = "C141657")
#> [1] "C174106"

# Both `term` and `clst_code` are vectorized. `clst_code` will be recycled
# to match `term` number of elements.
term_to_code(term = c("TENMW101", "TENMW102"), clst_code = "C141657")
#> [1] "C174106" "C141700"

# You may mix codelists as long as `term` and `clst_code` have the same
# number of elements; they will be matched element-wise.
term_to_code(
  term = c("TENMW101", "TENMW102", "TENMW1-Test Grade"),
  clst_code = c("C141657", "C141657", "C141656")
)
#> [1] "C174106" "C141700" "C141701"

# Invalid terms (e.g. `"Gambelas"`) map to `NA`.
term_to_code(term = c("TENMW101", "TENMW102", "Gambelas"), clst_code = "C141657")
#> [1] "C174106" "C141700" NA