您的位置:首页 > 编程语言 > C语言/C++

runtime_checks

2015-09-11 09:24 323 查看


/RTC (Run-Time Error Checks)

Used to enable and disable the run-time error checks feature, in conjunction with the runtime_checks pragma.

/RTC1
/RTCc
/RTCs
/RTCu



Arguments

1

Equivalent of /RTCsu.
c

Reports when a value is assigned to a smaller data type and results in a data loss. For example, if a value of type short
0x101 is assigned to a variable of type char.

This option reports situations in which you intend to truncate, for example, if you want the first eight bits of an int returned as a char. Because /RTCc causes
a run-time error if any information is lost as a result of the assignment, you can mask off the information you need to avoid a run-time error as a result of /RTCc. For
example:

#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

Enables stack frame run-time error checking, as follows:

Initialization of local variables to a nonzero value. This helps identify bugs that do not appear when running in debug mode. There is a greater
chance that stack variables will still be zero in a debug build compared to a release build because of compiler optimizations of stack variables in a release build. Once a program has used an area of its stack, it is
never reset to 0 by the compiler. Therefore, subsequent, uninitialized stack variables that happen to use the same stack area can return values left over from the prior use of this stack memory.

Detection of overruns and underruns of local variables such as arrays. /RTC s will not detect overruns
when accessing memory that results from compiler padding within a structure.Padding could occur by using align
(C++), /Zp (Struct Member Alignment), or pack,
or if you order structure elements in such a way as to require the compiler to add padding.

Stack pointer verification, which detects stack pointer corruption. Stack pointer corruption can be caused by a calling convention mismatch. For
example, using a function pointer, you call a function in a DLL that is exported as __stdcall but
you declare the pointer to the function as__cdecl.

u

Reports when a variable is used without having been initialized. For example, an instruction that generates C4701 may also generate a run-time error under /RTCu. Any
instruction that generatesCompiler Warning (level 1 and level 4) C4700 will generate
a run-time error under /RTCu.

However, consider the following code fragment:

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


If a variable could have been initialized, it will not be reported at run time by /RTCu. For example,
after a variable is aliased through a pointer, the compiler will not track the variable and report uninitialized uses. In effect, you can initialize a variable by taking its address. The
& operator works like an assignment operator in this situation.


Remarks

Run-time error checks are a way for you to find problems in your running code; for more information, seeHow
to: Use Native Run-Time Checks.

If you compile your program at the command line using any of the /RTC compiler options, any pragmaoptimize instructions
in your code will silently fail. This is because run-time error checks are not valid in a release (optimized) build.

You should use /RTC for development builds; /RTC should not be used for a retail build. /RTC cannot
be used with compiler optimizations (/O Options (Optimize Code)). A
program image built with /RTC will be slightly larger and slightly slower than an image built with /Od (up to 5 percent slower than an /Od build).

The __MSVC_RUNTIME_CHECKS preprocessor directive will be defined when you use any /RTC option or /GZ.


To set this compiler option in the Visual Studio development environment

Open the project's Property Pages dialog box. For details, see How
to: Open Project Property Pages.

Click the C/C++ folder.

Click the Code Generation property page.

Modify one or both of the following properties: Basic Runtime Checks or Smaller Type Check.


To set this compiler option programmatically

See BasicRuntimeChecks and SmallerTypeCheck properties.


runtime_checks

Disables or restores the /RTC settings.

#pragma runtime_checks( "[runtime_checks]", {restore | off} )



Remarks

You cannot enable a run-time check that was not enabled with a compiler option. For example, if you do not specify /RTCs, specifying #pragma
runtime_checks( "s", restore) will not enable stack frame verification.

The runtime_checks pragma must appear outside a function and takes effect at the first function defined after the pragma is seen. The restore and off arguments
turn options specified in the runtime_checks on or off.

The runtime_checks can be zero or more of the parameters shown in the following table.
Parameters of the runtime_checks Pragma

Parameter(s)
Type of run-time check
s
Enables stack (frame) verification.
c
Reports when a value is assigned to a smaller data type that results in a data loss.
u
Reports when a variable is used before it is defined.
These are the same letters used with the /RTC compiler option. For example:

#pragma runtime_checks( "sc", restore )


Using the runtime_checks pragma with the empty string ("") is a special form of the directive:

When you use the off parameter, it turns the run-time error checks, listed in the table above, off.

When you use the restore parameter, it resets the run-time error checks to those that you specified with the /RTC compiler option.

#pragma runtime_checks( "", off )
.
.
.
#pragma runtime_checks( "", restore )



做个记录,方便自己查看。上面的内容完全来自于下面两个链接中的内容。https://msdn.microsoft.com/zh-cn/library/8wtf2dfz(v=vs.120).aspx
https://msdn.microsoft.com/zh-cn/library/6kasb93x(v=vs.120).aspx

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签:  vs2012 c++