R ls.str 列表对象及其结构

说明

ls.str 和 lsf.str 是 ls 的变体，将 str() 应用于每个匹配的名称：请参阅值部分。

用法

ls.str(pos = -1, name, envir, all.names = FALSE,
       pattern, mode = "any")

lsf.str(pos = -1, envir, ...)

## S3 method for class 'ls_str'
print(x, max.level = 1, give.attr = FALSE, ...,
      digits = max(1, getOption("str")$digits.d))

参数

pos	指示 search 路径位置的整数，或当前环境的 -1。
name	指示 search 路径位置的可选名称，请参阅 ls 。
envir	使用环境，请参见ls。
all.names	逻辑指示是否省略以 . 开头的名称；请参阅ls。
pattern	regular expression 传递给 ls 。仅考虑与 pattern 匹配的名称。
max.level	用于显示嵌套结构的最大嵌套级别，例如包含子列表的列表。默认 1：仅显示第一个嵌套级别。
give.attr	逻辑性；如果TRUE(默认)，则将属性显示为子结构。
mode	指定要考虑的对象的 mode 的字符。传递给 exists 和 get 。
x	类 "ls_str" 的对象。
...	进一步的论点需要通过。 lsf.str 将它们传递给 ls.str，ls.str 将它们传递给 ls 。 (非导出)打印方法 print.ls_str 将它们传递给 str 。
digits	用于打印的有效位数。

值

ls.str 和 lsf.str 返回类 "ls_str" 的对象，本质上是匹配名称的字符向量(仅适用于 lsf.str 的函数)，与 ls 类似，具有调用 str() 的 print() 方法每个对象。

例子

require(stats)

lsf.str()  #- how do the functions look like which I am using?
ls.str(mode = "list")   #- what are the structured objects I have defined?

## create a few objects
example(glm, echo = FALSE)
ll <- as.list(LETTERS)
print(ls.str(), max.level = 0)# don't show details

## which base functions have "file" in their name ?
lsf.str(pos = length(search()), pattern = "file")

## demonstrating that  ls.str() works inside functions
## ["browser/debug mode"]:
tt <- function(x, y = 1) { aa <- 7; r <- x + y; ls.str() }
(nms <- sapply(strsplit(capture.output(tt(2))," *: *"), `[`, 1))
stopifnot(nms == c("aa", "r","x","y"))

作者

Martin Maechler

也可以看看

str、summary、args。