1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
|
#ifndef _NSTRING_H
#define _NSTRING_H
#include <stdarg.h>
#include <string.h>
#include <strings.h> /* For strncasecmp */
#include <ctype.h>
#include "pm_c_util.h"
#include "pm.h" /* For PM_GNU_PRINTF_ATTR, __inline__ */
#ifdef __cplusplus
extern "C" {
#endif
#if 0
} /* to fake out automatic code indenters */
#endif
/* Here are string functions that respect the size of the array
into which you are copying -- E.g. STRSCPY truncates the source string as
required so that it fits, with the terminating null, in the destination
array.
*/
#define STRSCPY(A,B) \
(strncpy((A), (B), sizeof(A)), *((A)+sizeof(A)-1) = '\0')
#define STRSCMP(A,B) \
(strncmp((A), (B), sizeof(A)))
#define STRSCAT(A,B) \
(strncpy(A+strlen(A), B, sizeof(A)-strlen(A)), *((A)+sizeof(A)-1) = '\0')
#define STRSEQ(A, B) \
(strneq((A), (B), sizeof(A)))
#define MEMEQ(a,b,c) (memcmp(a, b, c) == 0)
#define MEMSEQ(a,b) (memeq(a, b, sizeof(*(a))) == 0)
#define MEMSSET(a,b) (memset(a, b, sizeof(*(a))))
#define MEMSCPY(a,b) (memcpy(a, b, sizeof(*(a))))
#define MEMSZERO(a) (MEMSSET(a, 0))
static __inline__ int
streq(const char * const comparand,
const char * const comparator) {
return strcmp(comparand, comparator) == 0;
}
static __inline__ int
strneq(const char * const comparand,
const char * const comparator,
size_t const size) {
return strncmp(comparand, comparator, size) == 0;
}
static __inline__ int
memeq(const void * const comparand,
const void * const comparator,
size_t const size) {
return memcmp(comparand, comparator, size) == 0;
}
/* The Standard C Library may not declare strcasecmp() if the including
source file doesn't request BSD functions, with _BSD_SOURCE. So
we don't define functions that use strcasecmp() in that case.
*/
#ifdef _BSD_SOURCE
static __inline__ int
strcaseeq(const char * const comparand,
const char * const comparator) {
return strcasecmp(comparand, comparator) == 0;
}
static __inline__ int
strncaseeq(const char * const comparand,
const char * const comparator,
size_t const size) {
return strncasecmp(comparand, comparator, size) == 0;
}
#endif
/* The standard C library routines isdigit(), for some weird
historical reason, does not take a character (type 'char') as its
argument. Instead it takes an integer. When the integer is a whole
number, it represents a character in the obvious way using the local
character set encoding. When the integer is negative, the results
are undefined.
Passing a character to isdigit(), which expects an integer, results in
isdigit() sometimes getting a negative number.
On some systems, when the integer is negative, it represents exactly
the character you want it to anyway (e.g. -1 is the character that is
encoded 0xFF). But on others, it does not.
(The same is true of other routines like isdigit()).
Therefore, we have the substitutes for isdigit() etc. that take an
actual character (type 'char') as an argument.
*/
#define ISALNUM(C) (isalnum((unsigned char)(C)))
#define ISALPHA(C) (isalpha((unsigned char)(C)))
#define ISCNTRL(C) (iscntrl((unsigned char)(C)))
#define ISDIGIT(C) (isdigit((unsigned char)(C)))
#define ISGRAPH(C) (isgraph((unsigned char)(C)))
#define ISLOWER(C) (islower((unsigned char)(C)))
#define ISPRINT(C) (isprint((unsigned char)(C)))
#define ISPUNCT(C) (ispunct((unsigned char)(C)))
#define ISSPACE(C) (isspace((unsigned char)(C)))
#define ISUPPER(C) (isupper((unsigned char)(C)))
#define ISXDIGIT(C) (isxdigit((unsigned char)(C)))
#define TOUPPER(C) ((char)toupper((unsigned char)(C)))
/* These are all private versions of commonly available standard C
library subroutines whose names are the same except with the N at
the end. Because not all standard C libraries have them all,
Netpbm must include them in its own libraries, and because some
standard C libraries have some of them, Netpbm must use different
names for them.
The GNU C library has all of them. All but the oldest standard C libraries
have snprintf().
There are slight differences between the asprintf() family and that
found in other libraries:
- There is no return value.
- The returned string is a const char * instead of a char *. The
const is more correct.
- If the function can't get the memory, it returns 'pm_strsol',
which is a string that is in static memory that contains text
indicating an out of memory failure has occurred, intead of
NULL. This makes it much easier for programs to ignore this
possibility.
strfree() is strictly a Netpbm invention, to allow proper type checking
when freeing storage allocated by the Netpbm pm_asprintf().
*/
extern const char * const pm_strsol;
size_t
pm_strnlen(const char * const s,
size_t const maxlen);
int
pm_snprintf(char * const dest,
size_t const str_m,
const char * const fmt,
...) PM_GNU_PRINTF_ATTR(3,4);
void
pm_vsnprintf(char * const str,
size_t const str_m,
const char * const fmt,
va_list ap,
size_t * const sizeP);
const char *
pm_strdup(const char * const arg);
void
pm_asprintf(const char ** const resultP,
const char * const fmt,
...) PM_GNU_PRINTF_ATTR(2,3);
void
pm_vasprintf(const char ** const resultP,
const char * const format,
va_list args);
bool
pm_vasprintf_knows_float(void);
void
pm_strfree(const char * const string);
const char *
pm_strsep(char ** const stringP, const char * const delim);
int
pm_stripeq(const char * const comparand,
const char * const comparator);
const void *
pm_memmem(const void * const haystackArg,
size_t const haystacklen,
const void * const needleArg,
size_t const needlelen);
bool
pm_strishex(const char * const subject);
void
pm_interpret_uint(const char * const string,
unsigned int * const valueP,
const char ** const errorP);
void
pm_string_to_uint(const char * const string,
unsigned int * const uintP,
const char ** const errorP);
#ifdef __cplusplus
}
#endif
#endif
|