R message 診斷信息

說明

從其參數生成診斷消息。

用法

message(..., domain = NULL, appendLF = TRUE)
suppressMessages(expr, classes = "message")

packageStartupMessage(..., domain = NULL, appendLF = TRUE)
suppressPackageStartupMessages(expr)

.makeMessage(..., domain = NULL, appendLF = FALSE)

參數

...	零個或多個可以強製為字符的對象(並且不帶分隔符粘貼在一起)或(僅適用於message)單個條件對象。
domain	請參閱gettext。如果 NA ，消息將不會被翻譯，另請參閱 stop 中的注釋。
appendLF	邏輯：作為字符串給出的消息是否應該附加換行符？
expr	要評估的表達式。
classes	字符，指示應抑製哪些類別的消息。

細節

message 用於生成‘simple’ 診斷消息，這些消息既不是警告也不是錯誤，但仍然表示為條件。與警告和錯誤不同，最後的換行符被視為消息的一部分，並且是可選的。默認處理程序將消息發送到 stderr() connection 。

如果將條件對象提供給 message，它應該是唯一的參數，其他參數將被忽略，並出現警告。

處理消息時，muffleMessage 可以重新啟動。

suppressMessages 在忽略所有 ‘simple’ 診斷消息的上下文中計算其表達式。

packageStartupMessage 是一種變體，其消息可以通過 suppressPackageStartupMessages 單獨抑製。 (它們仍然是消息，因此可以被 suppressMessages 抑製。)

.makeMessage 是 message 、 warning 和 stop 使用的實用程序，通過可能的翻譯(請參閱 gettext )和串聯(無分隔符)從 ... 參數生成文本消息。

例子

message("ABC", "DEF")
suppressMessages(message("ABC"))

testit <- function() {
  message("testing package startup messages")
  packageStartupMessage("initializing ...", appendLF = FALSE)
  Sys.sleep(1)
  packageStartupMessage(" done")
}

testit()
suppressPackageStartupMessages(testit())
suppressMessages(testit())

也可以看看

warning 和 stop 用於生成警告和錯誤； conditions 用於條件處理和恢複。

gettext 用於文本自動翻譯的機製。