Skip to contents

Check and set behaviour for lost labels

Source: R/lost_labels_action.R
lost_labels_action.Rd

This function determines the behaviour to adopt when labelled variables of a datatagr are lost for example through subsetting. This is achieved using options defined for the datatagr package.

Usage

lost_labels_action(action = c("warning", "error", "none"), quiet = FALSE)

get_lost_labels_action()

Arguments

action

a character indicating the behaviour to adopt when labelled variables have been lost: "error" (default) will issue an error; "warning" will issue a warning; "none" will do nothing

quiet

a logical indicating if a message should be displayed; only used outside pipelines

Value

returns NULL; the option itself is set in options("datatagr")

Details

The errors or warnings generated by datatagr in case of labelled variable loss has a custom class of datatagr_error and datatagr_warning respectively.

Examples

# reset default - done automatically at package loading
lost_labels_action()
#> Lost labels will now issue a warning.

# check current value
get_lost_labels_action()
#> [1] "warning"

# change to issue errors when tags are lost
lost_labels_action("error")
#> Lost labels will now issue an error.
get_lost_labels_action()
#> [1] "error"

# change to ignore when tags are lost
lost_labels_action("none")
#> Lost labels will now be ignored.
get_lost_labels_action()
#> [1] "none"

# reset to default: warning
lost_labels_action()
#> Lost labels will now issue a warning.