Inspect or change CONTVARIABLE.
Setting CONTVARIABLE indexes several variables in table2. Removing CONTVARIABLE removes the indexing from table2.
Usage
px_contvariable(x, value, validate)
# S3 method for class 'px'
px_contvariable(x, value, validate = TRUE)
Arguments
- x
A px object
- value
Optional. A character string. If missing, the current CONTVARIABLE is returned. If NULL, CONTVARIABLE 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 CONTVARIABLE
x1 <-
px(population_gl) |>
px_contvariable('gender')
# After setting CONTVARIABLE some variables are index by it, e.g. UNITS
px_units(x1)
#> # A tibble: 2 × 3
#> code language value
#> <chr> <chr> <chr>
#> 1 female NA units
#> 2 male NA units
# Remove CONTVARIABLE
x2 <- px_contvariable(x1, NULL)
px_contvariable(x2)
#> NULL
# Removing CONTVARIABLE also removes the index from UNITS
px_units(x2)
#> [1] "units"