-qhalt (-Werror)

适用的调用

表 1. 接受给定选项的调用
选项 xlc (编译 C) xlC (编译 C++) xlclang(编译 C) xlclang++(编译 C++)
-qhalt
-Werror    
注: 此表中仅列出典型调用。 对于所有基本调用及其等效特殊调用,您可以参阅 编译器调用的完整列表

类别

错误检查和调试

等效编译指示

表 2。 两个类别的调用的编译指示等效项
xlc/xlC 和其他遗留的调用命令 xlclang/xlclang + + 调用命令
#pragma 个选项停止

用途

如果编译时消息的最大严重性级别等于或超过您指定的严重性级别,那么将在生成任何对象文件、可执行文件或汇编程序源文件之前停止编译。

语法

表 3。 针对两个类别的调用的 -qhalt-Werror 语法
xlc/xlC 和其他遗留调用 xlclang/xlclang + + 调用命令

-qhalt 语法 (针对 C)

读取语法图跳过可视语法图  -qhalt = siwe

-qhalt 语法 (针对 C + +)

读取语法图跳过可视语法图  -qhalt = siw
读取语法图跳过可视语法图 -qhalt =w
读取语法图跳过可视语法图 -Werror

缺省值

xlc/xlC 和其他遗留调用 xlclang/xlclang + +
-qhalt=s -qhalt=w (-Werror) 因为已禁用自动重新调度路由器。

参数

基于 XL 的前端开始i
指定要针对所有类型的错误停止编译: 警告,错误和参考。 参考诊断 (I) 的严重性最低。
w
指定针对警告 (W) 和所有类型的错误停止编译。
基于 XL 的前端开始仅限 Ce
指定针对错误 (E) ,严重错误 (S) 和不可恢复错误 (U) 停止编译。
基于 XL 的前端开始s
仅限 C 指定编译在出现严重错误(S)和不可恢复的错误(U)时停止。 仅限 C + + 指定在出现严重错误时停止编译(S)。

使用量

当编译器由于 halt 选项而停止时,编译器返回码为非零。 有关返回码的列表,请参阅 编译器返回码

多次指定 -qhalt 时,将使用最低严重性级别。

基于 XL 的前端开始

诊断消息可由 -qflag 选项控制。

您还可以指示编译器根据严重性类型的错误数停止编译,方法是使用 -qmaxerr 选项,这将覆盖 -qhalt

您还可以使用 -qhaltonmsg 选项根据错误消息号停止编译。

基于 XL 的前端端

预定义的宏

无。

示例

要编译 myprogram.c 以便在出现警告或更高级别的消息时停止编译,请输入:
xlc myprogram.c -qhalt=w

相关信息