| rk.get.label {rkward} | R Documentation |
rk.get.label retrieves the rkward label (if any) of the given object.
rk.get.label(x) rk.set.label(x, label, envir = parent.frame()) rk.list.labels(x, fill = FALSE) rk.get.short.name(x) .rk.make.short.name(x) rk.get.description(..., paste.sep = NULL, is.substitute = FALSE) rk.list(...) rk.list.names(..., deparse.level = 2)
x |
any R object |
label |
a string, to set the label attribute of an object |
envir |
an environment, where the attribute is evaluated |
fill |
a logical or character. See Details. |
paste.sep |
a string, used as the |
is.substitute |
a logical (not NA). See Details. |
rk.set.label sets the rkward label for the given object.
rk.list.labels retrieves the rkward labels for a list of objects.
Most importantly, this can be used for extracting all column labels in a
data.frame, conveniently. The parameter fill controls, what
happens, when no rkward labels have been assigned. The default (FALSE)
is to return empty strings for any missing labels. For fill=TRUE, missing
labels will be filled with the short names of the object. You can also pass
a character vector of default labels to use as the fill parameter.
rk.get.short.name creates a short name for the given object.
rk.get.description creates descriptive string(s) for each of the
arguments in "...{}"; collapsing into a single string using
paste.sep (if not NULL). If is.substitute=TRUE, the arguments
will be deparsed, first, which can be useful when using
rk.get.description inside a function.
rk.list.names returns the names of the arguments passed as
...; when using rk.list.names inside a function, it may be
necessary to increase the deparse.level level.
rk.list returns a list of its arguments, with names set as
returned by rk.get.description(). This can be used as a drop-in
replacement for list.
rk.set.label returns the result of the evaluation of "setting
the label" while the others return a character vector.
Thomas Friedrichsmeier rkward-devel@kde.org
x <- data.frame(a=c(1:3), b=c(2:4)) rk.set.label(x[["a"]], "First column") rk.get.short.name (x$a) # "x$a" rk.get.label (x$a) # "First column" rk.get.description (x$a) # "x$a (First column)" rk.list.labels (x) # "First column" "" rk.list.labels (x, TRUE) # "First column" "b" rk.list.names (x, x$a, x$b) # "x" "x$a" "x$b" names (rk.list (x$a, x$b)) # "x$a (First column)" "x$b"