1SEMESS(3NCARG)                   NCAR GRAPHICS                  SEMESS(3NCARG)
2
3
4

NAME

6       SEMESS - Called by a user to get a specified portion of the current
7       error message.
8

SYNOPSIS

10       MESSG = SEMESS(ITRIM)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       char *c_semess(int itrim)
16

DESCRIPTION

18       In any routine that references SEMESS, it must be declared to be of
19       type CHARACTER*113.
20
21       If the internal error flag of SETER is non-zero, the value of the
22       character expression "SEMESS(ITRIM)" is the remembered error message
23       associated with that error flag, trimmed as indicated by the value of
24       the input quantity ITRIM.  Otherwise, it is a string of blanks.
25
26       When ITRIM = 0 or less, no trimming is done; the whole error message is
27       returned.  When ITRIM = 1, prepended routine names and the associated
28       slashes are trimmed off.  When ITRIM = 2 or greater, all leading
29       routine names are trimmed off; just the error description is returned.
30
31       Example: Assume that the current error message is the string
32       "CPCLAM/AREDAM - AREA-MAP ARRAY OVERFLOW"; then, SEMESS(0) is that
33       entire string, while SEMESS(1) = "AREDAM - AREA-MAP ARRAY OVERFLOW",
34       and SEMESS(2) = "AREA-MAP ARRAY OVERFLOW".
35
36       The argument of SEMESS is as follows:
37
38
39       ITRIM       (an input expression of type INTEGER) - Says what part of
40                   the error message is to be returned, as detailed above.
41

C-BINDING DESCRIPTION

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

EXAMPLES

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

ACCESS

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

SEE ALSO

55       Online: entsr, eprin, errof, error_handling, fdum, icfell, icloem,
56       nerro, retsr, seter, ncarg_cbind
57

59       Copyright (C) 1987-2009
60       University Corporation for Atmospheric Research
61       The use of this Software is governed by a License Agreement.
62
63
64
65UNIX                              March 1994                    SEMESS(3NCARG)
Impressum