check

Checks for certain conditions at run time.

IDE Equivalent

Windows:
Run-time > Runtime Error Checking
(/nocheck, /check:all, or /check:none)
Run-time > Check Array and String Bounds
(/check:[no]bounds)
Run-time > Check Uninitialized Variables
(/RTCu)
Run-time > Check Edit Descriptor Data Type
(/check:[no]format)
Run-time > Check Edit Descriptor Data Size
(/check:[no]output_conversion)
Run-time > Check For Actual Arguments Using Temporary Storage
(/check:[no]arg_temp_created)
Linux: None

Architectures

IA-32, IntelŪ EM64T, IntelŪ ItaniumŪ architecture

Syntax

Linux: -check [keyword]
-nocheck
Windows:    /check[:keyword]
/nocheck

Arguments

keyword     Specifies the run-time conditions to check. Possible values are:
  none Prevents all run-time checking.
  [no]arg_temp_created Determines whether checking occurs for actual arguments before routine calls.
  [no]bounds Determines whether checking occurs for bounds of array subscript and substring references.
  [no]format Determines whether checking occurs for the data type of an item being formatted for output.
  [no]output_conversion Determines whether checking occurs for the fit of data items within a designated format descriptor field.
  [no]uninit
(Windows only)
Determines whether checking occurs for uninitialized variables.
  all Enables all check options.

Default

OFF No checking is performed for run-time failures. Note that if option vms is specified, the defaults are check format and check output_conversion.

Description

This option checks for certain conditions at run time.

Option

Description

check none Prevents all checking for run-time failures. Disables all check options (same as nocheck).
check arg_temp_created    Generates code to check if actual arguments are copied into temporary storage before routine calls. If a copy is made at run-time, an informative message is displayed.
check bounds Generates code to perform run-time checks on array subscript and character substring expressions. An error is reported if the expression is outside the dimension of the array or the length of the string.
For array bounds, each individual dimension is checked. Array bounds checking is not performed for arrays that are dummy arguments in which the last dimension bound is specified as * or when both upper and lower dimensions are 1.
Once the program is debugged, omit this option to reduce executable program size and slightly improve run-time performance.
check format Issues the run-time FORVARMIS fatal error when the data type of an item being formatted for output does not match the format descriptor being used (for example, a REAL*4 item formatted with an I edit descriptor).
With check noformat, the data item is formatted using the specified descriptor unless the length of the item cannot accommodate the descriptor (for example, it is still an error to pass an INTEGER*2 item to an E edit descriptor).
check output_conversion Issues the run-time OUTCONERR continuable error message when a data item is too large to fit in a designated format descriptor field without loss of significant digits. Format truncation occurs, the field is filled with asterisks (*), and execution continues.
check uninit
(Windows only)
Generates code to check for uninitialized variables. If a variable is read before written, a run-time error routine will be called. This option is incompatible with any optimization type other than debug.
check all Enables all check options. This is the same as specifying check with no keyword.

Alternate Options

check none Linux: -nocheck
Windows: /nocheck, /4Nb
check bounds    Linux: -CB
Windows: /CB
check uninit Linux: None
Windows: /RTCu
check all Linux: -check, -C
Windows: /check, /4Yb, /C