R语言【base】——warning()，suppressWarnings()

Package base version 4.2.0

---

Descripioin

生成一个警告消息，该消息对应于它的参数和(可选)调用它的表达式或函数。

---

Usage

warning(..., call. = TRUE, immediate. = FALSE, noBreaks. = FALSE,
        domain = NULL)

suppressWarnings(expr, classes = "warning")

---

Arguments

参数【...】：0个或多个可以被强制为字符的对象(并且它们不带分隔符粘贴在一起)或单个条件对象。

参数【call.】：逻辑的，指示调用是否应该成为警告消息的一部分。

参数【immediate.】：逻辑的，指示是否应该立即输出调用，即使getOption("warn") <= 0。

参数【noBreaks.】：逻辑的，表示当选项(warn = 1)时，消息应尽可能作为单行输出。

参数【expr】：表达式。

参数【domain】：详见gettext。如果是NA，信息将不会被翻译，参见stop中的注释。

参数【classes】：字符，指示应该抑制哪类警告。

---

Details

结果取决于选项("warn")的值和执行代码中建立的处理程序。

如果提供了一个条件对象，它应该是唯一的参数，其他参数将被忽略，并带有一条消息。

warning通过(有效地)调用signalCondition来表示一个警告条件。如果没有处理程序或所有处理程序都返回，则使用warn = getOption("warn")的值来确定适当的操作。如果warn为负值，则忽略警告;如果为零，则在顶层函数完成后存储并打印;如果是1，它们就会被打印出来，如果是2(或更大)，警告就会变成错误。

warning(immediate. = TRUE)将warn <= 0转换为warn = 1。

如果warn为零(默认值)，则创建只读变量last.warning。它包含可以通过调用warnings来打印的警告。

警告将被截断为getOption("warning.length")字符，默认为1000，由[… truncated]表示。

在处理警告时，可以使用一个muffleWarning重新启动。如果使用invokeRestart调用此重启，则立即返回警告。

试图强制其他类型的输入警告字符向量。

suppressWarnings在忽略所有警告的上下文中计算其表达式。

---

Value

警告消息为字符串，不可见。

---

Examples

testit <- function() warning("testit")
testit()

Warning in testit() : testit

suppressWarnings(warning("testit"))