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-2007
60       University Corporation for Atmospheric Research
61
62       This documentation is free software; you can redistribute it and/or
63       modify it under the terms of the GNU General Public License as
64       published by the Free Software Foundation; either version 2 of the
65       License, or (at your option) any later version.
66
67       This software is distributed in the hope that it will be useful, but
68       WITHOUT ANY WARRANTY; without even the implied warranty of
69       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
70       General Public License for more details.
71
72       You should have received a copy of the GNU General Public License along
73       with this software; if not, write to the Free Software Foundation,
74       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
75
76
77
78UNIX                              March 1994                    SEMESS(3NCARG)
Impressum