SASxport (version 1.7.0)

SASformat: Set or Retrieve the 'label', 'SASformat', 'SASiformat', or 'SAStype' attribute of a vector or (components of) a data frame

Description

Sets or retrieves the "SASformat", "SASiformat", or SAStype attribute of an object.

More comprehensive support for object labels, and SASformat, are available in Frank Harrell's Hmisc package.

Note that SAStype enforces the SAS 8-character naming convention.

Usage

SASformat(x, default)
SASformat(x) <- value
SASiformat(x, default)
SASiformat(x) <- value
SAStype(x, default)
SAStype(x) <- value

Arguments

x

any object

value

new value for the "label", "SASformat", "SASiformat", or SAStype attribute of an object.

default

value to return when no appropriate attribute is found. The usual return value is NULL.

Value

the contents of the "label", "SASformat", "SASiformat", "SAStype" attribute of x, if any; otherwise, the value provided by default.

Examples

# NOT RUN {
## Examples for vectors

fail.time <- c(10,20)

# set attributes
SASformat(fail.time) <- 'Numeric2'
SASiformat(fail.time) <- 'Numeric2'

# display individual attributes
SASformat(fail.time)
SASiformat(fail.time)

# display all attributes
attributes(fail.time)

## SAStype only applies to data frames
df <- data.frame( fail.time, day=c("Mon","Tue"), stringsAsFactors=TRUE )
SAStype(df) <- "USER"

SAStype(df)

## Example showing specification of default return value
a <- 70
label(a, default="no label")
# }