R sourceutils 源参考实用程序

说明

这些函数从源引用中提取信息。

用法

getSrcFilename(x, full.names = FALSE, unique = TRUE)
getSrcDirectory(x, unique = TRUE)
getSrcref(x)
getSrcLocation(x, which = c("line", "column", "byte", "parse"),
               first = TRUE)

参数

x	包含源引用的对象(通常是函数)。
full.names	是否在文件名结果中包含完整路径。
unique	是否仅列出唯一的文件名/目录。
which	提取源参考的哪一部分。可以缩写。
first	是否显示对象的第一个(或最后一个)位置。

细节

如果 "keep.source" 选项为 TRUE ，则函数的每个语句都将有其自己的源引用。这些函数检索所有这些。

其组成部分如下：

线

对象开始或结束的行号。

柱子

对象开始或结束的列号。水平制表符将转换为空格。

字节

至于 "column" ，但计算字节，在多字节字符(和水平制表符)的情况下可能会有所不同。

解析

至于 "line" ，但这会忽略 #line 指令。

值

getSrcFilename 和 getSrcDirectory 返回保存文件名/目录的字符向量。

getSrcref 返回 "srcref" 对象的列表，如果没有，则返回 NULL。

getSrcLocation 返回请求的位置类型的整数向量。

例子

fn <- function(x) {
  x + 1 # A comment, kept as part of the source
}			

# Show the temporary file directory
# where the example was saved

getSrcDirectory(fn)
getSrcLocation(fn, "line")

也可以看看

srcref , getParseData