SEMESS(3) Called by a user to get a specified portion of the current error

SYNOPSIS

MESSG = SEMESS(ITRIM)

C-BINDING SYNOPSIS

#include <ncarg/ncargC.h>

char *c_semess(int itrim)

DESCRIPTION

In 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:

ITRIM
(an input expression of type INTEGER) - Says what part of the error message is to be returned, as detailed above.

C-BINDING DESCRIPTION

The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

EXAMPLES

Use the ncargex command to see the following relevant examples: tseter, arex02.

ACCESS

To use SEMESS or c_semess, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.