找回密码
 注册
查看: 13907|回复: 1

R语言:readLines()函数中文帮助文档(中英文对照)

[复制链接]
发表于 2012-2-16 21:20:33 | 显示全部楼层 |阅读模式
readLines(base)
readLines()所属R语言包:base

                                        Read Text Lines from a Connection
                                         从连接中读取文本行

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

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

Read some or all text lines from a connection.
阅读部分或从连接所有文本行。


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


readLines(con = stdin(), n = -1L, ok = TRUE, warn = TRUE,
          encoding = "unknown")



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

参数:con
a connection object or a character string.
一个连接对象或一个字符串。


参数:n
integer.  The (maximal) number of lines to read.  Negative values indicate that one should read up to the end of input on the connection.
整数。读取的行数(最大)。负值表示,应该读的输入端连接上。


参数:ok
logical.  Is it OK to reach the end of the connection before n > 0 lines are read?  If not, an error will be generated.
逻辑。这是确定连接年底之前达到n > 0行读取?如果没有,将会产生错误。


参数:warn
logical.  Warn if a text file is missing a final EOL.
逻辑。警告说,如果一个文本文件中缺少一个最终停产。


参数:encoding
encoding to be assumed for input strings.  It is used to mark character strings as known to be in Latin-1 or UTF-8: it is not used to re-encode the input.  To do the latter, specify the encoding as part of the connection con or via options(encoding=): see the example under file. See also "Details".  
假设输入字符串编码。它是用来标记字符串,被称为是在拉丁美洲-1或UTF-8:不使用它来重新编码输入。要做到后者,编码指定为连接con部分或通过options(encoding=)下file看到的例子。另见“详细资料”。


Details

详情----------Details----------

If the con is a character string, the function calls file to obtain a file connection which is opened for the duration of the function call.  As from R 2.10.0 this can be a compressed file.
如果con是一个字符串,函数调用file获得函数调用的时间打开一个文件连接。从R 2.10.0可以是一个压缩文件。

If the connection is open it is read from its current position.  If it is not open, it is opened in "rt" mode for the duration of the call and then closed again.
如果连接是打开的,它是从当前位置读取。如果它是不开放的,它是打开"rt"模式,通话时间,然后再次关闭。

If the final line is incomplete (no final EOL marker) the behaviour depends on whether the connection is blocking or not.  For a non-blocking text-mode connection the incomplete line is pushed back, silently.  For all other connections the line will be accepted, with a warning.
如果最后一行是不完整的(没有最后的EOL标记)取决于连接是否被阻塞或不行为。对于一个非阻塞的文本模式连接不完整的生产线推回,悄无声息。对于所有其他连接线将被接受,一个警告。

Whatever mode the connection is opened in, any of LF, CRLF or CR will be accepted as the EOL marker for a line.
打开连接在任何模式,任何行的EOL标记将被接纳为低频的CRLF或CR。

If con is a not-already-open connection with a non-default encoding argument, the text is converted to UTF-8 and declared as such (and the encoding argument to readLines is ignored). See the examples.
con如果是一个非默认已经打开的连接encoding的说法,文本转换为UTF-8,因此宣布(和encoding参数readLines被忽略)。见的例子。


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

A character vector of length the number of lines read.
特征向量的长度读取的行数。

The elements of the result have a declared encoding if encoding is "latin1" or "UTF-8",
结果元素有一个声明的编码,如果encoding是"latin1"或"UTF-8"


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

The default connection, stdin, may be different from con = "stdin": see file.
默认的连接,stdin,可能是不同con = "stdin":看到file。


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

connections, writeLines, readBin,
connections,writeLines,readBin


举例----------Examples----------


cat("TITLE extra line", "2 3 5 7", "", "11 13 17", file="ex.data",
    sep="\n")
readLines("ex.data", n=-1)
unlink("ex.data") # tidy up[清理]

## difference in blocking[#在阻塞的区别]
cat("123\nabc", file = "test1")
readLines("test1") # line with a warning[警告线]

con <- file("test1", "r", blocking = FALSE)
readLines(con) # empty[空的]
cat(" def\n", file = "test1", append = TRUE)
readLines(con) # gets both[获得两个]
close(con)

unlink("test1") # tidy up[清理]

## Not run: [#无法运行:]
# read a 'Windows Unicode' file [阅读“的Windows Unicode的文件]
A <- readLines(file("Unicode.txt", encoding="UCS-2LE"))
unique(Encoding(A)) # will most likely be UTF-8[将最有可能是UTF-8]


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


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

使用道具 举报

发表于 2015-3-3 09:28:51 | 显示全部楼层
{:soso_e183:}
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

手机版|小黑屋|生物统计家园 网站价格

GMT+8, 2025-1-22 19:46 , Processed in 0.024192 second(s), 16 queries .

Powered by Discuz! X3.5

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表