ncl_semess (3) - Linux Man Pages
ncl_semess: Called by a user to get a specified portion of the current error
SEMESS - Called by a user to get a specified portion of the current error message.
SYNOPSISMESSG = SEMESS(ITRIM)
C-BINDING SYNOPSIS#include <ncarg/ncargC.h>
DESCRIPTIONIn any routine that references SEMESS, it must be declared to be of type CHARACTER*113.
If the internal error flag of SETER is non-zero, the value of the character expression "SEMESS(ITRIM)" is the remembered error message associated with that error flag, trimmed as indicated by the value of the input quantity ITRIM. Otherwise, it is a string of blanks.
When ITRIM = 0 or less, no trimming is done; the whole error message is returned. When ITRIM = 1, prepended routine names and the associated slashes are trimmed off. When ITRIM = 2 or greater, all leading routine names are trimmed off; just the error description is returned.
Example: Assume that the current error message is the string "CPCLAM/AREDAM - AREA-MAP ARRAY OVERFLOW"; then, SEMESS(0) is that entire string, while SEMESS(1) = "AREDAM - AREA-MAP ARRAY OVERFLOW", and SEMESS(2) = "AREA-MAP ARRAY OVERFLOW".
The argument of SEMESS is as follows:
- (an input expression of type INTEGER) - Says what part of the error message is to be returned, as detailed above.
C-BINDING DESCRIPTIONThe C-binding argument descriptions are the same as the FORTRAN argument descriptions.
EXAMPLESUse the ncargex command to see the following relevant examples: tseter, arex02.
ACCESSTo use SEMESS or c_semess, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.
COPYRIGHTCopyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.