1 |
dashley |
71 |
/* $Header$ */ |
2 |
|
|
/* |
3 |
|
|
* regerror - error-code expansion |
4 |
|
|
* |
5 |
|
|
* Copyright (c) 1998, 1999 Henry Spencer. All rights reserved. |
6 |
|
|
* |
7 |
|
|
* Development of this software was funded, in part, by Cray Research Inc., |
8 |
|
|
* UUNET Communications Services Inc., Sun Microsystems Inc., and Scriptics |
9 |
|
|
* Corporation, none of whom are responsible for the results. The author |
10 |
|
|
* thanks all of them. |
11 |
|
|
* |
12 |
|
|
* Redistribution and use in source and binary forms -- with or without |
13 |
|
|
* modification -- are permitted for any purpose, provided that |
14 |
|
|
* redistributions in source form retain this entire copyright notice and |
15 |
|
|
* indicate the origin and nature of any modifications. |
16 |
|
|
* |
17 |
|
|
* I'd appreciate being given credit for this package in the documentation |
18 |
|
|
* of software which uses it, but that is not a requirement. |
19 |
|
|
* |
20 |
|
|
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, |
21 |
|
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY |
22 |
|
|
* AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL |
23 |
|
|
* HENRY SPENCER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
24 |
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
25 |
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; |
26 |
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, |
27 |
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
28 |
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF |
29 |
|
|
* ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
30 |
|
|
* |
31 |
|
|
*/ |
32 |
|
|
|
33 |
|
|
#include "regguts.h" |
34 |
|
|
|
35 |
|
|
/* unknown-error explanation */ |
36 |
|
|
static char unk[] = "*** unknown regex error code 0x%x ***"; |
37 |
|
|
|
38 |
|
|
/* struct to map among codes, code names, and explanations */ |
39 |
|
|
static struct rerr { |
40 |
|
|
int code; |
41 |
|
|
char *name; |
42 |
|
|
char *explain; |
43 |
|
|
} rerrs[] = { |
44 |
|
|
/* the actual table is built from regex.h */ |
45 |
|
|
# include "regerrs.h" |
46 |
|
|
{ -1, "", "oops" }, /* explanation special-cased in code */ |
47 |
|
|
}; |
48 |
|
|
|
49 |
|
|
/* |
50 |
|
|
- regerror - the interface to error numbers |
51 |
|
|
*/ |
52 |
|
|
/* ARGSUSED */ |
53 |
|
|
size_t /* actual space needed (including NUL) */ |
54 |
|
|
regerror(errcode, preg, errbuf, errbuf_size) |
55 |
|
|
int errcode; /* error code, or REG_ATOI or REG_ITOA */ |
56 |
|
|
CONST regex_t *preg; /* associated regex_t (unused at present) */ |
57 |
|
|
char *errbuf; /* result buffer (unless errbuf_size==0) */ |
58 |
|
|
size_t errbuf_size; /* available space in errbuf, can be 0 */ |
59 |
|
|
{ |
60 |
|
|
struct rerr *r; |
61 |
|
|
char *msg; |
62 |
|
|
char convbuf[sizeof(unk)+50]; /* 50 = plenty for int */ |
63 |
|
|
size_t len; |
64 |
|
|
int icode; |
65 |
|
|
|
66 |
|
|
switch (errcode) { |
67 |
|
|
case REG_ATOI: /* convert name to number */ |
68 |
|
|
for (r = rerrs; r->code >= 0; r++) |
69 |
|
|
if (strcmp(r->name, errbuf) == 0) |
70 |
|
|
break; |
71 |
|
|
sprintf(convbuf, "%d", r->code); /* -1 for unknown */ |
72 |
|
|
msg = convbuf; |
73 |
|
|
break; |
74 |
|
|
case REG_ITOA: /* convert number to name */ |
75 |
|
|
icode = atoi(errbuf); /* not our problem if this fails */ |
76 |
|
|
for (r = rerrs; r->code >= 0; r++) |
77 |
|
|
if (r->code == icode) |
78 |
|
|
break; |
79 |
|
|
if (r->code >= 0) |
80 |
|
|
msg = r->name; |
81 |
|
|
else { /* unknown; tell him the number */ |
82 |
|
|
sprintf(convbuf, "REG_%u", (unsigned)icode); |
83 |
|
|
msg = convbuf; |
84 |
|
|
} |
85 |
|
|
break; |
86 |
|
|
default: /* a real, normal error code */ |
87 |
|
|
for (r = rerrs; r->code >= 0; r++) |
88 |
|
|
if (r->code == errcode) |
89 |
|
|
break; |
90 |
|
|
if (r->code >= 0) |
91 |
|
|
msg = r->explain; |
92 |
|
|
else { /* unknown; say so */ |
93 |
|
|
sprintf(convbuf, unk, errcode); |
94 |
|
|
msg = convbuf; |
95 |
|
|
} |
96 |
|
|
break; |
97 |
|
|
} |
98 |
|
|
|
99 |
|
|
len = strlen(msg) + 1; /* space needed, including NUL */ |
100 |
|
|
if (errbuf_size > 0) { |
101 |
|
|
if (errbuf_size > len) |
102 |
|
|
strcpy(errbuf, msg); |
103 |
|
|
else { /* truncate to fit */ |
104 |
|
|
strncpy(errbuf, msg, errbuf_size-1); |
105 |
|
|
errbuf[errbuf_size-1] = '\0'; |
106 |
|
|
} |
107 |
|
|
} |
108 |
|
|
|
109 |
|
|
return len; |
110 |
|
|
} |
111 |
|
|
|
112 |
|
|
/* End of regerror.c */ |