1.9　搜索幫助文檔

1.9.1　問題

你要了解有關計算機上安裝的某一函數的更多信息，但是help函數無法找到任何該函數的文檔。

或者，你要在已安裝的文檔中搜索某個關鍵字。

1.9.2　解決方案

使用help.search函數搜索計算機上的R文檔：

---

help.search("pattern")

---

此命令意在搜索名為pattern的某一函數或者關鍵字。注意：命令中pattern兩邊必須加上英文雙引號。

為方便起見，你還可以使用兩個問號來調用搜索（在這種情況下，不需要引號）。請注意，使用一個問號將按名稱搜索該函數，使用兩個問號將搜索符合pattern的文檔：

---

> ??pattern

---

1.9.3　討論

在搜索幫助文檔的過程中，可能會遇到R軟件無法給出任何搜索項的相關信息的情況，例如：

---

help(adf.test)
#> No documentation for 'adf.test' in specified packages and libraries:
#> you could try '??adf.test'

---

如果你確定在計算機中安裝了該函數，則導致這種情況的原因可能是由于包含該函數的R包未載入，你不知道哪個包中包含該函數。這有點類似于一個無法擺脫的困境（catch-22，報錯消息提示無法在搜索路徑下找到該R包，因此R無法找到幫助文件；有關詳細信息，請參閱3.6節）。

解決方案是搜索所有已安裝的添加包，來找到該函數。按錯誤信息中提示的方法來進行搜索（即使用help.search函數），例如：

---

help.search("adf.test")?

---

搜索結果將生成包含該函數的所有R包的列表：

---

Help files with alias or concept or title matching 'adf.test' using
regular expression matching:

tseries::adf.test       Augmented Dickey-Fuller Test
Type '?PKG::FOO' to inspect entry 'PKG::FOO TITLE'.

---

前面的輸出表明tseries包中包含adf.test函數。可以再次使用help命令，在help的參數中明確指明，需要幫助文檔的R函數所在的R包。例如：

---

help(adf.test, package = "tseries")

---

或者你可以使用雙冒號運算符告訴R查看特定的R包：

---

?tseries::adf.test

---

你可以使用關鍵字擴大搜索范圍。然后，R將找到包含關鍵字的任何已安裝文檔。假設你要查找含有Augmented Dickey-Fuller（ADF）檢驗的所有函數，則可以通過以下命令：

---

help.search("dickey-fuller")

---

1.9.4　另請參閱

你還可以通過文檔瀏覽器訪問本地搜索引擎；有關如何訪問搜索引擎，請參閱1.7節。有關搜索路徑的詳細信息，請參閱3.6節。有關函數幫助的細節，請參閱1.8節。