R语言【base】——将单个 R 对象写入文件并将其还原的函数：saveRDS()，readRDS() 和 infoRDS()

ALittleHigh2023-12-31 13:56

Package base version 4.3.2

Parameters

R 复制代码

saveRDS(object, file = "", ascii = FALSE, version = NULL,
        compress = TRUE, refhook = NULL)

readRDS(file, refhook = NULL)

infoRDS(file)

参数【object】：要序列化的 R 对象。

参数【file】：连接或R 对象保存或读取的文件名。

参数【ascii】：逻辑值。如果为 TRUE 或 NA，则写入 ASCII 表示；否则（默认），使用二进制表示。

参数【version】：要使用的工作区格式版本。NULL 表示当前默认版本（3 ）。唯一支持的其他值是 2 ，即从 R 1.4.0 到 R 3.5.0 的默认值。

参数【compress】：逻辑值，用于指定保存到指定文件时是否使用 **"gzip"压缩，或使用 "gzip"、"bzip2"**或 "xz" 中的一种来表示压缩类型。如果参数【file】是连接，则忽略。

参数【refhook】：钩子函数，用于处理引用对象。

saveRDS 和 readRDS 提供了将单个 R 对象保存到连接（通常是文件）并还原对象（很可能以不同的名称）的方法。这与save 和 load不同，save 和 load是将一个或多个命名对象保存和恢复到环境中。它们被 R 本身广泛使用，例如用于存储软件包的元数据和存储help.search数据库：**".rds"**文件扩展名最常用。

函数 serialize 和 unserialize 为序列化提供了一个稍低级别的接口：通过 serialize序列化到连接的对象可以通过 readRDS 读回，反之亦然。

infoRDS 不能用于检测文件是否是序列化，也不能用于检测文件是否有效。

所有这些接口都使用相同的序列化格式，但 save 会在单个对象（所有要保存对象的对列表）的序列化之前写入一行标题（通常为 "RDXs/n"）。

如果参数【file】是一个文件名，它将由 gzfile 打开，除非 **save(compress = FALSE)**使用文件。只有在例外情况下，才会标记无法转换为 Windows 本地编码的文件编码。