Normalize incoming column names so ppVar placeholders can require exact,
syntactic, unique column-name matches at runtime.
Arguments
- data
A data frame or an object coercible with
as.data.frame().
Value
A tabular object with ggpaintr-safe column names. Existing
data.frame subclasses keep their class. Names are made syntactic, unique,
and safe against reserved-word collisions. Non-data.frame inputs return
the data.frame created by as.data.frame().
Details
Uploaded data is normalized automatically by the runtime — every
successful ppUpload placeholder passes through this function (or its
data.frame-coercing sibling for non-data.frame returns from
readRDS / readxl / jsonlite). Call ptr_normalize_column_names()
yourself only for in-session data frames you reference by name from
a formula. If a local data frame has spaces, reserved words, or
duplicates in its column names, pipe it through this function before
passing it to ptr_app().
Examples
messy <- data.frame(
check.names = FALSE,
"first column" = 1:3,
"if" = 4:6
)
clean <- ptr_normalize_column_names(messy)
names(clean)
#> [1] "first_column" "if_"