mariposa (version 0.7.3)

write_xpt: Export Data to SAS Transport Format

Description

Writes a data frame to a SAS transport file (.xpt), preserving variable labels and missing value types. Tagged NAs from any source format (SPSS, Stata, SAS) are written as SAS special missing values (.A through .Z, ._).

Usage

write_xpt(data, path, version = 5, name = NULL)

Value

Invisibly returns the file path.

Arguments

data

A data frame to export.

path

Path to the output file. Must end in .xpt.

version

SAS transport file version. Either 5 (default, SAS Transport v5, most compatible) or 8 (SAS Transport v8, supports longer variable names).

name

Member name for the dataset within the transport file. If NULL, derived from the file name. Maximum 8 characters for version 5.

Details

Tagged NA Handling

SAS supports 28 special missing values: . (system missing), .A through .Z, and ._. When exporting data with tagged NAs:

• From SAS (read_sas(), read_xpt()): Native special missing values are preserved in a full roundtrip.

• From SPSS (read_spss()): Tagged NAs are written as SAS special missing values. The original SPSS numeric codes (e.g., -9, -8) are not preserved, but the distinct missing value types are.

• From Stata (read_stata()): Stata extended missing values are mapped to their SAS equivalents.

Limitations

SAS transport files do not store value labels. If your data has value labels, consider using write_spss() or write_xlsx() instead, which preserve full label metadata. Variable labels are preserved.

See Also

read_xpt() and read_sas() for importing SAS files, write_spss() for SPSS export, write_stata() for Stata export, write_xlsx() for Excel export

Other data-export: write_spss(), write_stata(), write_xlsx()

Examples

# \donttest{
if (requireNamespace("haven", quietly = TRUE)) {
  # Roundtrip: write to a temporary .xpt transport file, read back
  tmp <- tempfile(fileext = ".xpt")
  write_xpt(survey_data, tmp)
  data <- read_xpt(tmp)

  unlink(tmp)
}
# }