R语言 SASxport包 write.xport()函数中文帮助文档(中英文对照)

loveR

write.xport(SASxport)
write.xport()所属R语言包：SASxport

                                        Write Data to a SAS XPORT File
                                         写入SAS XPORT文件的数据

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

This function writes one or more data frames into a SAS XPORT format library file.
此功能将一个或多个数据框写入到一个SAS的XPORT格式的库文件。


用法----------Usage----------


write.xport(...,
            list=base::list(),
            file = stop("'file' must be specified"),
            verbose=FALSE,
            sasVer="7.00",
            osType,
            cDate=Sys.time(),
            formats=NULL,
            autogen.formats=TRUE
)



参数----------Arguments----------

参数：...
One or more data frames to be stored  
以被存储的一个或多个数据框


参数：list
A list containing data frames to be stored.
一个列表，其中包含的数据框进行存储。


参数：file
File name or connection object. Use "" to view the raw data
文件名称或连接的对象。使用“查看原始数据


参数：verbose
Logical flag controlling whether status is reported during processing
逻辑标志控制是否在加工过程中的状态报告


参数：sasVer
SAS version string
SAS版本字符串


参数：osType
Opererating system, defaults to "R X.Y.Z" for appropriate values of X, Y, and Z
为适当的值X，Y和Z Opererating系统，默认为“R XYZ”


参数：cDate
Date object specifying dataset creation date
Date对象指定数据集的创建日期


参数：formats
Optional data frame containing SAS format information.
可选的数据框包含SAS格式的信息。


参数：autogen.formats
Logical indiciating whether SAS formats should be auto-generated for factor variables.
SAS格式的的逻辑indiciating是否应该自动生成的因子变量。


Details

详细信息----------Details----------

The function creates a SAS XPORT data file (see reference) from one or more data frames.  This file format imposes a number of constraints:  
该函数创建一个SAS的XPORT数据文件（见参考文献），从一个或多个数据框。这种文件格式规定了一些限制：

Data set and variable names are truncated to 8 characters and converted to upper case.  All characters outside of the set A-Z, 0-9, and '\_' are converted to '\_'.
数据集和变量名被截断为8个字符，转换为大写。以外的所有字符集AZ ,0-9，\ _转换为\ _。

Character variables are stored as characters.
字符变量被存储为字符。

If autogen.formats=TRUE (the default), factor variables are stored as numeric with an appropriate SAS format specification. If autogen.formats=FALSE, factor variables are stored as characters.
如果autogen.formats=TRUE（默认值），因子变量都存储为数字与相应的SAS格式规范。如果autogen.formats=FALSE，因子变量存储为字符。

All numeric variables are stored as double-precision floating point values utilizing the IBM mainframe double precision floating point format (see the reference).
所有数字变量存储为双精度浮点值，利用IBM大型机的双精度浮点格式（见参考）。

Date and time variables are either converted to number of days since 1960-01-01 (date only), or number of seconds since 1960-01-01:00:00:00 GMT (date-time variables).   
日期和时间变量转换为自1960年1月1日的天数（仅日期），或1960-01-01:00:00:00日期，时间变量（GMT）以来的秒数。

Missing values are converted to the standard SAS missing value '.' </ul>
遗漏值被转换为标准的SAS缺失值“。 </ ul>

In addition, the SAS XPORT format allows each variable to have a corresponding label, display format, and input format.  To set these values, add the   attribute 'label', 'SASformat', or 'SASiformat' to individual data frame variables. (See the example section.)
此外，SAS的XPORT格式允许每个变量具有一个对应的标签，显示格式，并且输入格式。要设置这些值，添加属性“标签”，“SASformat”，或“SASiformat的单个数据框的变量。 （请参见示例部分。）

The actual translation of R objects to objects appropriate for SAS is handled by the toSAS generic and associated methods.   
实际翻译的R对象的对象适用于SAS toSAS通用的，关联的方法来处理。


值----------Value----------

No return value
没有返回值


注意----------Note----------

This package was created by Random Technologies LLC http://random-technologies-llc.com with partial funding by Metrum Institute http://metruminstitute.org.
这个包的随机技术有限责任公司http://random-technologies-llc.com部分资金由Metrum研究所http://metruminstitute.org。

Technical support contracts for this and other R packages are available from Random Technologies LLC http://random-technologies-llc.com.
技术支持合同，这和其他R包都可以从随机技术有限责任公司http://random-technologies-llc.com。


（作者）----------Author(s)----------


Gregory R. Warnes <a href="mailto:greg@warnes.net">greg@warnes.net</a>



参考文献----------References----------

SAS Technical Support document TS-140: &ldquo;The Record Layout of a Data Set in SAS Transport (XPORT) Format&rdquo; available at http://ftp.sas.com/techsup/download/technote/ts140.html.

参见----------See Also----------

toSAS, lookup.xport, read.xport
toSAS，lookup.xport，read.xport


实例----------Examples----------



#####[＃＃＃＃]
## R version of the example given in TS-140[＃R版本的TS-140中给出的例子]
#####[＃＃＃＃]

## manually create a data set[＃手动创建一个数据集]
temp <- data.frame( x=c(1, 2, NA, NA ), y=c('a', 'B', NA, '*' ) )

## look at it[＃看看]
temp

## add a format specifier (not used by R)[＃添加的格式说明符（不使用由R）]
attr(temp$x, 'SASformat') <- 'date7.'

## add a variable label (not used by R)[＃添加一个变量标签（未使用由R）]
attr(temp$y, 'label')  <- 'character variable'

## verify the additions[＃验证的补充。]
str(temp)

## rename the data set[＃重命名数据集]
abc <- temp

# create a SAS XPORT file [创建一个SAS XPORT文件]
write.xport( abc, file="xxx.dat" )

# list the contents of the file[列出的文件的内容]
lookup.xport("xxx.dat")

## reload the data[＃重新加载数据]
xxx.abc <- read.xport("xxx.dat")

## and look at it[＃看看它]
xxx.abc

## Note that the variable names have been converted to uppercase[＃需要注意的是已转换为大写的变量名]


转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。