Inspect or change VALUES.
Arguments
- x
A px object
- value
Optional. A data frame with the columns 'values' and one or more of the columns: 'variable-code', 'code', and 'language'. If 'value' is missing, the current VALUES is returned. If NULL, VALUES is removed.
- validate
Optional. If TRUE a number of validation checks are performed on the px object, and an error is thrown if the object is not valid. If FALSE, the checks are skipped, which can be usefull for large px objects where the check can be time consuming. Use
px_validate()
to manually preform the check.
Examples
# Set VALUES for a value
library(tibble)
x1 <-
population_gl |>
px() |>
px_values(
tribble(~`variable-code`, ~code, ~values,
'year', '2004', 'Year 2024'))
# Print VALUES
px_values(x1)
#> # A tibble: 10 × 3
#> `variable-code` code value
#> <chr> <chr> <chr>
#> 1 gender female female
#> 2 gender male male
#> 3 age 0-6 0-6
#> 4 age 17-24 17-24
#> 5 age 25-64 25-64
#> 6 age 65+ 65+
#> 7 age 7-16 7-16
#> 8 year 2004 Year 2024
#> 9 year 2014 2014
#> 10 year 2024 2024
# Set VALUES for a value in specific language
x2 <-
x1 |>
px_languages(c('en', 'kl')) |>
px_values(
tribble(~`variable-code`, ~code, ~language, ~values,
'age', '0-6', 'en', 'toddler',
'age', '0-6', 'kl', 'meeraaqqap'))
px_values(x2)
#> # A tibble: 2 × 4
#> `variable-code` code language value
#> <chr> <chr> <chr> <chr>
#> 1 age 0-6 en toddler
#> 2 age 0-6 kl meeraaqqap
# Remove VALUES
x3 <- px_values(x2, NULL)
px_values(x3)
#> NULL