Skip to contents

Inspect or change VALUENOTEX.

Usage

px_valuenotex(x, value, validate)

# S3 method for class 'px'
px_valuenotex(x, value, validate = TRUE)

Arguments

x

A px object

value

Optional. A data frame with the columns 'valuenotex' and one or more of the columns: 'variable-code', 'code', and 'language'. If 'value' is missing, the current VALUENOTEX is returned. If NULL, VALUENOTEX 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.

Value

A px object or data frame.

Examples

# Set VALUENOTEX for a value
library(tibble)
x1 <-
  population_gl |>
  px() |>
  px_valuenotex(
    tribble(~`variable-code`, ~code,  ~valuenotex,
            'year', '2004', 'Counts are approximated'))

# Print VALUENOTEX
px_valuenotex(x1)
#> # A tibble: 1 × 4
#>   `variable-code` code  language valuenotex             
#>   <chr>           <chr> <chr>    <chr>                  
#> 1 year            2004  NA       Counts are approximated

# Set VALUENOTEX for a value in specific language
x2 <-
  x1 |>
  px_languages(c('en', 'kl')) |>
  px_valuenotex(
    tribble(~`variable-code`, ~code,  ~language, ~valuenotex,
            'age', '0-6', 'en', 'Some of the figures are from 2003',
            'age', '0-6', 'kl', 'Kisitsisit ilaat 2003-imeersuupput'))
px_valuenotex(x2)
#> # A tibble: 2 × 4
#>   `variable-code` code  language valuenotex                        
#>   <chr>           <chr> <chr>    <chr>                             
#> 1 age             0-6   en       Some of the figures are from 2003 
#> 2 age             0-6   kl       Kisitsisit ilaat 2003-imeersuupput

# Remove VALUENOTEX
x3 <- px_valuenotex(x2, NULL)
px_valuenotex(x3)
#> NULL