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 用于文本自动翻译的机制。