C/C++ Compiler (cl.hlp) (
Table of Contents;
Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
Check Null Pointers (/Zr)
◄Up► ◄Contents► ◄Index► ◄Back►
─────C/C++ Compiler─────────────────────────────────────────────────────────
The /Zr option checks for null or out-of-range pointers in your
program. A run-time error occurs if you try to run a program with
such pointers. The /Zr option is only available with the fast
compile (/f) option.
If you compile with the /Zr option, you can use the
check_pointer pragma within your source file to turn checking
on or off only for selected pointers leaving the default (see
below) for the remaining pointers in the program. When you want to
turn on pointer checking, put the following line before the usage
of the pointer you want to check:
#pragma check_pointer (on)
This line turns on pointer checking for all pointers that follow
it in the source file, not just the pointers on the following
line. To turn off pointer checking, insert the following line at
the location you want pointer checking turned off:
#pragma check_pointer (off)
If you don't give an argument for the check_pointer pragma,
pointer checking reverts to the behavior specified on the command
line: turned on if the /Zr option is given or turned off
otherwise.
For example:
/Zr PROG.C
This command causes CL to check for null or out-of-range pointers
in the file PROG.C. All pointers in the file are checked except
those to which a check_pointer(off) pragma applies.
-♦-