check_stack

  • Article

#pragma check_stack([ {on | off}] )

#pragma check_stack{+ | –}

Instructs the compiler to turn off stack probes if off (or –) is specified, or to turn on stack probes if on (or +) is specified. If no argument is given, stack probes are treated according to the default. This pragma takes effect at the first function defined after the pragma is seen. Stack probes are not a part of macros nor of functions that are generated inline.

If you don’t give an argument for the check_stack pragma, stack checking reverts to the behavior specified on the command line. For more information, see Compiler Reference. The interaction of the #pragma check_stack and the /Gs option is summarized in Table 2.1.

Table 2.1   Using the check_stack Pragma

Syntax Compiled with
/Gs option?		 Action
#pragma check_stack( ) or
#pragma check_stack		 Yes Turns off stack checking for functions that follow
#pragma check_stack( ) or
#pragma check_stack		 No Turns on stack checking for functions that follow
#pragma check_stack(on) or
#pragma check_stack +		 Yes or no Turns on stack checking for functions that follow
#pragma check_stack(off) or
#pragma check_stack –		 Yes or no Turns off stack checking for functions that follow