/RTC(运行时错误检查)

更新:2007 年 11 月

用于启用和禁用运行时错误检查功能,与 runtime_checks 杂注一起使用。

/RTC1
/RTCc
/RTCs
/RTCu

参数

  • 1
    /RTCsu 的等效项。

  • c
    当向较小的数据类型赋值从而导致数据丢失时报告。例如,当将类型 short 0x101 的值赋给类型 char 的变量时。

    此选项报告您打算截断的情况,例如,您希望将 int 的前八位作为 char 返回的情况。因为 /RTCc 在由于赋值而丢失任何信息时将导致运行时错误,您可以屏蔽所需的信息以避免由于 /RTCc 而产生的运行时错误。例如:

    #include <crtdbg.h>
    
    char get8bits(int value, int position) {
       _ASSERT(position < 32);
       return (char)(value >> position);
       // Try the following line instead:
       // return (char)((value >> position) && 0xff);
    }
    
    int main() {
       get8bits(12341235,3);
    }
    
  • s
    启用堆栈帧运行时错误检查,如下所示:

    • 将局部变量初始化为非零值。这有助于识别在调试模式下运行时不出现的 bug。因为在发布版本中编译器对堆栈变量进行优化,所以与发布版本相比,堆栈变量在调试版本中仍然为零的可能性更大。一旦程序使用其堆栈区域后,它就永远不会由编译器重置为 0。因此,恰好在随后使用相同堆栈区域的未初始化堆栈变量就可能返回上次使用该堆栈内存时留下的值。

    • 检测局部变量(例如数组)的溢出和不足。/RTCs 将不检测当访问内存时由结构内的编译器填充导致的溢出。当使用 align (C++)/Zp(结构成员对齐)pack 时,或者以某种方式对结构元素进行排序以致要求编译器添加填充时,可能发生填充。

    • 堆栈指针验证,该操作检测堆栈指针损坏。调用约定不匹配可能导致堆栈指针损坏。例如,使用函数指针调用 DLL 中作为 __stdcall 导出的函数,但将指向该函数的指针声明为 __cdecl

  • u
    当使用尚未初始化的变量时报告。例如,生成 编译器警告(等级 1)C4701 的指令也可能在 /RTCu 下生成运行时错误。生成 编译器警告(级别 1 和级别 4)C4700 的任何指令将在 /RTCu 下生成运行时错误。

    然而,请考虑下列代码片段:

    int a, *b, c;
    if ( 1 )
    b = &a;
    c = a;  // No run-time error with /RTCu
    

    如果变量可能已经初始化,则 /RTCu 在运行时将不报告。例如,在通过指针为变量起别名以后,编译器将不再跟踪此变量并报告未初始化使用。实际上,可以通过获取其地址来初始化变量。在这种情况下,& 运算符的作用类似于赋值运算符。

备注

运行时错误检查是发现运行的代码中的问题的一种途径;有关更多信息,请参见 如何:使用本机运行时检查

如果在命令行上使用任一 /RTC 编译器选项编译程序,代码中的任何杂注 optimize 指令将失败而不给出任何提示。这是因为运行时错误检查在发布(优化)版本中无效。

对于开发版本,应该使用 /RTC;对于零售版本,不应该使用 /RTC/RTC 不能与编译器优化 (/O 选项(优化代码)) 一起使用。与用 /Od 生成的映像相比,用 /RTC 生成的程序映像稍大一些,速度也稍慢一些(最多比 /Od 版本慢 5%)。

当使用任何 /RTC 选项或 /GZ 时,将定义 __MSVC_RUNTIME_CHECKS 预处理器指令。

在 Visual Studio 开发环境中设置此编译器选项

  1. 打开此项目的“属性页”对话框。有关详细信息,请参见如何:打开项目属性页

  2. 单击“C/C++”文件夹。

  3. 单击“代码生成”属性页。

  4. 修改下列属性之一或两者都修改:“基本运行时检查”或“较小类型检查”。

以编程方式设置此编译器选项

智能设备开发人员说明

对于设备编译器,只有 x86 上支持 RTC 功能,而且此功能没有在 Visual Studio IDE 中作为 Visual C++ 设备项目的一个属性设置公开。但是,如果您面向的是 x86,则可以在 IDE 中的“C/C++ 命令行”属性页上的“附加选项”窗格中设置此选项。

请参见

任务

RTC 示例:运行时错误检查

参考

编译器选项

设置编译器选项