R warning 警告信息

说明

生成与其参数和(可选)调用它的表达式或函数相对应的警告消息。

用法

warning(..., call. = TRUE, immediate. = FALSE, noBreaks. = FALSE,
        domain = NULL)
suppressWarnings(expr, classes = "warning")

参数

...	零个或多个可以强制为字符的对象(并且不带分隔符粘贴在一起)或单个条件对象。
call.	逻辑，指示调用是否应成为警告消息的一部分。
immediate.	逻辑，指示是否应立即输出调用，即使 getOption("warn") <= 0 。
noBreaks.	逻辑上，指示当 options(warn = 1) 时消息应尽可能作为单行输出。
expr	要评估的表达式。
domain	请参阅gettext。如果 NA ，消息将不会被翻译，另请参阅 stop 中的注释。
classes	字符，指示应抑制哪些类别的警告。

细节

结果取决于options("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 调用此重新启动，则 warning 立即返回。

尝试将 warning 的其他类型的输入强制为字符向量。

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

值

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

例子

testit <- function() warning("testit")
testit() ## shows call
testit <- function() warning("problem in testit", call. = FALSE)
testit() ## no call
suppressWarnings(warning("testit"))

参考

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

也可以看看

stop 表示致命错误，message 表示诊断消息，warnings 和带有参数 warn= 的 options 。

gettext 用于消息自动翻译的机制。