R dump R 对象的文本表示

说明

该函数采用名称向量R对象并生成文件或连接上对象的文本表示。 Adump文件通常可以是sourced 进入另一个R会议。

用法

dump(list, file = "dumpdata.R", append = FALSE,
     control = "all", envir = parent.frame(), evaluate = TRUE)

参数

list	特征向量(或NULL)。的名字R要倾倒的物体。
file	命名文件的字符串或 connection 。 ""表示输出到控制台。
append	如果TRUE和file是字符串，则输出将附加到file；否则，它将覆盖 file 的内容。
control	指示解析选项的字符向量(或 NULL )。有关其说明，请参阅.deparseOpts。
envir	搜索对象的环境。
evaluate	合乎逻辑的。承诺是否应该被评估？

细节

如果某些指定的对象不存在(在范围内)，则它们将被省略，并带有警告。如果 file 是一个文件并且不存在任何对象，则不会创建文件。

source ing 可能不会生成 dump ed 对象的相同副本。如果可能出现问题，例如在转储奇异或复杂对象时(请参阅注释)，则会发出警告。

如果写入文件的字符少于预期，dump 也会发出警告，这可能表明文件系统已满或损坏。

A dump文件可以是sourced 进入另一个R(或者也许是S)会话，但是函数save和saveRDS设计用于运输R数据，并将与R对象dump不处理。为了获得最大的重复性使用control = "exact".

要生成更易读的对象表示，请使用 control = NULL 。这将跳过属性，并进行其他简化，使 source 不太可能生成相同的副本。有关详细信息，请参阅.deparseOpts。

要解析函数的内部表示而不是显示保存的源，请使用control = c("keepInteger", "warnIncomplete", "keepNA")。这将丢失所有格式和注释，但在保存的源不再正确的情况下可能有用。

用户通常只会在延迟加载时(当默认的 evaluate = TRUE 必不可少时)以及在使用 delayedAssign 之后(当可能需要 evaluate = FALSE 时)才会遇到 Promise。

值

包含转储对象名称的不可见字符向量。

注意

由于 dump 是在基本命名空间中定义的，因此将在全局环境之前搜索 base 包，除非从顶级提示符调用 dump 或显式给出 envir 参数。

为了避免源属性与实际函数定义不同步的风险，函数的源属性永远不会被转储为属性。

当前环境、外部指针、弱引用和 S4 类型的对象不会以 source d 的方式进行解析。此外，无论 control 的值如何，language objects 都会以简单的方式进行解析，这包括不转储它们的属性(这将导致警告)。

例子

x <- 1; y <- 1:10
fil <- tempfile(fileext=".Rdmped")
dump(ls(pattern = '^[xyz]'), fil)
print(.Last.value)
unlink(fil)

参考

Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) The New S Language. Wadsworth & Brooks/Cole.

也可以看看

.deparseOpts 用于可用的 control 设置； dput() 、 dget() 和 deparse() 用于使用相同内部解析函数的相关函数。

write 、 write.table 等用于 “dumping” 数据到(文本)文件。

save和saveRDS更可靠的保存方式R对象。