read_table()
旨在读取每列由一列(或多列)空格分隔的文本数据类型。
read_table()
与 read.table()
类似,它允许列之间有任意数量的空白字符,并且行可以具有不同的长度。
spec_table()
返回列规范而不是 DataFrame 。
用法
read_table(
file,
col_names = TRUE,
col_types = NULL,
locale = default_locale(),
na = "NA",
skip = 0,
n_max = Inf,
guess_max = min(n_max, 1000),
progress = show_progress(),
comment = "",
show_col_types = should_show_types(),
skip_empty_rows = TRUE
)
参数
- file
-
文件路径、连接或文字数据(单个字符串或原始向量)。
以
.gz
、.bz2
、.xz
或.zip
结尾的文件将自动解压缩。将自动下载以http://
、https://
、ftp://
或ftps://
开头的文件。远程gz文件也可以自动下载并解压。文字数据对于示例和测试最有用。要被识别为文字数据,输入必须用
I()
包装,是包含至少一个换行符的字符串,或者是至少包含一个带有换行符的字符串的向量。使用值
clipboard()
将从系统剪贴板读取。 - col_names
-
TRUE
、FALSE
或列名称的字符向量。如果
TRUE
,输入的第一行将用作列名称,并且不会包含在 DataFrame 中。如果FALSE
,将自动生成列名称:X1、X2、X3 等。如果
col_names
是字符向量,则这些值将用作列的名称,并且输入的第一行将被读入输出数据帧的第一行。缺少 (
NA
) 列名将生成警告,并用虚拟名称...1
、...2
等进行填充。重复的列名将生成警告并使其唯一,请参阅name_repair
来控制其方式完毕。 - col_types
-
NULL
、cols()
规范或字符串之一。有关更多详细信息,请参阅vignette("readr")
。如果是
NULL
,则所有列类型都将从输入的guess_max
行推断出来,散布在整个文件中。这很方便(而且快速),但不够稳健。如果猜测的类型错误,您需要增加guess_max
或自己提供正确的类型。由
list()
或cols()
创建的列规范必须为每一列包含一个列规范。如果您只想读取列的子集,请使用cols_only()
。或者,您可以使用紧凑的字符串表示形式,其中每个字符代表一列:
-
c = 字符
-
我 = 整数
-
n = 数字
-
d = 双
-
l = 逻辑
-
f = 因子
-
D = 日期
-
T = 日期时间
-
t = 时间
-
? = 猜猜
-
_ 或 - = 跳过
默认情况下,读取没有列规范的文件将打印一条消息,显示
readr
猜测的内容。要删除此消息,请设置show_col_types = FALSE
或设置 `options(readr.show_col_types = FALSE)。 -
- locale
-
区域设置控制默认值因地而异。默认区域设置为 US-centric(如 R),但您可以使用
locale()
创建自己的区域设置来控制默认时区、编码、小数标记、大标记和日/月名称等内容。 - na
-
要解释为缺失值的字符串的字符向量。将此选项设置为
character()
以指示没有缺失值。 - skip
-
读取数据之前要跳过的行数。
- n_max
-
读取的最大行数。
- guess_max
-
用于猜测列类型的最大行数。永远不会使用超过读取的行数。有关更多详细信息,请参阅
vignette("column-types", package = "readr")
。 - progress
-
显示进度条?默认情况下,它只会在交互式会话中显示,而不会在编织文档时显示。可以通过将选项
readr.show_progress
设置为FALSE
来禁用自动进度条。 - comment
-
用于标识评论的字符串。注释字符之后的任何文本都将被默默忽略。
- show_col_types
-
如果是
FALSE
,则不显示猜测的列类型。如果TRUE
始终显示列类型,即使提供了列类型。如果NULL
(默认)仅在col_types
参数未显式提供列类型时显示列类型。 - skip_empty_rows
-
空白行应该被完全忽略吗?即,如果此选项是
TRUE
,则根本不会表示空白行。如果是FALSE
,则它们将由所有列中的NA
值表示。
也可以看看
read_fwf()
读取固定宽度文件,其中每列不以空格分隔。 read_fwf()
对于读取非标准格式的表格数据也很有用。
例子
ws <- readr_example("whitespace-sample.txt")
writeLines(read_lines(ws))
#> first last state phone
#> John Smith WA 418-Y11-4111
#> Mary Hartford CA 319-Z19-4341
#> Evan Nolan IL 219-532-c301
read_table(ws)
#>
#> ── Column specification ──────────────────────────────────────────────────
#> cols(
#> first = col_character(),
#> last = col_character(),
#> state = col_character(),
#> phone = col_character()
#> )
#> # A tibble: 3 × 4
#> first last state phone
#> <chr> <chr> <chr> <chr>
#> 1 John Smith WA 418-Y11-4111
#> 2 Mary Hartford CA 319-Z19-4341
#> 3 Evan Nolan IL 219-532-c301
相关用法
- R readr read_rds 读/写 RDS 文件。
- R readr read_lines 从文件中读取/写入行
- R readr read_fwf 将固定宽度文件读入 tibble
- R readr read_builtin 从包中读取内置对象
- R readr read_delim 将分隔文件(包括 CSV 和 TSV)读入 tibble
- R readr read_file 读/写完整文件
- R readr read_log 将通用/组合日志文件读入 tibble
- R readr readr_example 获取 readr 示例的路径
- R readr datasource 创建源对象。
- R readr melt_delim 返回分隔文件中每个标记的熔化数据(包括 csv 和 tsv)
- R readr parse_number 灵活地解析数字
- R readr Tokenizers 分词器。
- R readr melt_table 返回空格分隔文件中每个标记的熔化数据
- R readr date_names 创建或检索日期名称
- R readr type_convert 重新转换现有 DataFrame 中的字符列
- R readr locale 创建语言环境
- R readr write_delim 将数据帧写入分隔文件
- R readr parse_vector 解析字符向量。
- R readr with_edition 暂时更改活动阅读器版本
- R readr format_delim 将 DataFrame 转换为分隔字符串
- R readr edition_get 检索当前活动版本
- R readr melt_fwf 返回固定宽度文件中每个标记的熔化数据
- R readr count_fields 计算文件每一行中的字段数
- R readr problems 检索解析问题
- R readr parse_guess 使用“最佳”类型进行解析
注:本文由纯净天空筛选整理自Hadley Wickham等大神的英文原创作品 Read whitespace-separated columns into a tibble。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。