R ls 列出對象

說明

ls 和 objects 返回給出指定環境中對象名稱的字符串向量。當在頂級提示符下不帶參數調用時，ls 顯示用戶定義了哪些數據集和函數。當在函數內不帶參數調用時，ls 返回函數局部變量的名稱：這與 browser 結合使用非常有用。

用法

ls(name, pos = -1L, envir = as.environment(pos),
   all.names = FALSE, pattern, sorted = TRUE)
objects(name, pos= -1L, envir = as.environment(pos),
        all.names = FALSE, pattern, sorted = TRUE)

參數

name	列出可用對象時使用哪個環境。默認為當前環境。雖然為了向後兼容而稱為name，但實際上這個參數可以以任何形式指定環境；請參閱“詳細信息”部分。
pos	name 的替代參數，用於將環境指定為搜索列表中的位置。主要是為了向後兼容。
envir	name 的替代參數，用於指定環境。主要是為了向後兼容。
all.names	一個邏輯值。如果TRUE，返回所有對象名稱。如果FALSE，以‘開頭的名稱⁠.⁠’被省略。
pattern	可選的 regular expression 。僅返回與 pattern 匹配的名稱。 glob2rx 可用於將通配符模式轉換為正則表達式。
sorted	邏輯指示結果character是否應按字母順序排序。請注意，這是 ls() 的一部分，可能會占用大部分時間。

細節

name 參數可以指定以多種形式之一獲取對象名稱的環境： 作為整數(search 列表中的位置)；作為搜索列表中元素的字符串名稱；或作為顯式environment(包括使用sys.frame 訪問當前活動的函數調用)。默認情況下，使用調用 ls 或 objects 的環境。 pos 和 envir 參數是指定環境的另一種方法，但主要是為了向後兼容。

請注意，sorted = TRUE 的字符串順序取決於區域設置，請參閱 Sys.getlocale 。如果sorted = FALSE 順序是任意的，具體取決於環境是否經過哈希處理、對象插入的順序，...

例子

.Ob <- 1
ls(pattern = "O")
ls(pattern= "O", all.names = TRUE)    # also shows ".[foo]"

# shows an empty list because inside myfunc no variables are defined
myfunc <- function() {ls()}
myfunc()

# define a local variable inside myfunc
myfunc <- function() {y <- 1; ls()}
myfunc()                # shows "y"

參考

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

也可以看看

glob2rx 用於將通配符模式轉換為正則表達式。

ls.str 基於 str 的長列表。 apropos (或 find )用於在整個搜索路徑中查找對象； grep 有關“正則表達式”的更多詳細信息； class 、 methods 等，用於麵向對象編程。