This is Unofficial EPICS BASE Doxygen Site
Macros | Functions
epicsString.h File Reference
#include <stdio.h>
#include "epicsTypes.h"
#include "libComAPI.h"
+ Include dependency graph for epicsString.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros

#define epicsStrSnPrintEscaped   epicsStrnEscapedFromRaw
 

Functions

LIBCOM_API int epicsStrnRawFromEscaped (char *outbuf, size_t outsize, const char *inbuf, size_t inlen)
 
LIBCOM_API int epicsStrnEscapedFromRaw (char *outbuf, size_t outsize, const char *inbuf, size_t inlen)
 
LIBCOM_API size_t epicsStrnEscapedFromRawSize (const char *buf, size_t len)
 
LIBCOM_API int epicsStrCaseCmp (const char *s1, const char *s2)
 
LIBCOM_API int epicsStrnCaseCmp (const char *s1, const char *s2, size_t len)
 
LIBCOM_API char * epicsStrDup (const char *s)
 
LIBCOM_API char * epicsStrnDup (const char *s, size_t len)
 
LIBCOM_API int epicsStrPrintEscaped (FILE *fp, const char *s, size_t n)
 
LIBCOM_API size_t epicsStrnLen (const char *s, size_t maxlen)
 
LIBCOM_API int epicsStrGlobMatch (const char *str, const char *pattern)
 
LIBCOM_API char * epicsStrtok_r (char *s, const char *delim, char **lasts)
 
LIBCOM_API unsigned int epicsStrHash (const char *str, unsigned int seed)
 
LIBCOM_API unsigned int epicsMemHash (const char *str, size_t length, unsigned int seed)
 
LIBCOM_API int dbTranslateEscape (char *s, const char *ct)
 

Macro Definition Documentation

#define epicsStrSnPrintEscaped   epicsStrnEscapedFromRaw

Definition at line 36 of file epicsString.h.

Function Documentation

LIBCOM_API int dbTranslateEscape ( char *  s,
const char *  ct 
)

Definition at line 30 of file epicsString.c.

31 {
32  size_t big_enough = strlen(src) + 1;
33 
34  return epicsStrnRawFromEscaped(dst, big_enough, src, big_enough);
35 }
epicsStrnRawFromEscaped
int epicsStrnRawFromEscaped(char *dst, size_t dstlen, const char *src, size_t srclen)
Definition: epicsString.c:37
LIBCOM_API unsigned int epicsMemHash ( const char *  str,
size_t  length,
unsigned int  seed 
)

Definition at line 369 of file epicsString.c.

370 {
371  unsigned int hash = seed;
372 
373  while (length--) {
374  hash ^= ~((hash << 11) ^ *str++ ^ (hash >> 5));
375  if (!length--) break;
376  hash ^= (hash << 7) ^ *str++ ^ (hash >> 3);
377  }
378  return hash;
379 }
LIBCOM_API int epicsStrCaseCmp ( const char *  s1,
const char *  s2 
)

Definition at line 191 of file epicsString.c.

192 {
193  while (1) {
194  int ch1 = toupper((int) *s1);
195  int ch2 = toupper((int) *s2);
196 
197  if (ch2 == 0) return (ch1 != 0);
198  if (ch1 == 0) return -1;
199  if (ch1 < ch2) return -1;
200  if (ch1 > ch2) return 1;
201  s1++;
202  s2++;
203  }
204 }
LIBCOM_API char* epicsStrDup ( const char *  s)

Definition at line 233 of file epicsString.c.

234 {
235  return strcpy(mallocMustSucceed(strlen(s)+1, "epicsStrDup"), s);
236 }
mallocMustSucceed
LIBCOM_API void * mallocMustSucceed(size_t size, const char *msg)
A malloc() that never returns NULL.
Definition: cantProceed.c:38
LIBCOM_API int epicsStrGlobMatch ( const char *  str,
const char *  pattern 
)

Definition at line 279 of file epicsString.c.

280 {
281  const char *cp = NULL, *mp = NULL;
282 
283  while ((*str) && (*pattern != '*')) {
284  if ((*pattern != *str) && (*pattern != '?'))
285  return 0;
286  pattern++;
287  str++;
288  }
289  while (*str) {
290  if (*pattern == '*') {
291  if (!*++pattern)
292  return 1;
293  mp = pattern;
294  cp = str+1;
295  }
296  else if ((*pattern == *str) || (*pattern == '?')) {
297  pattern++;
298  str++;
299  }
300  else {
301  pattern = mp;
302  str = cp++;
303  }
304  }
305  while (*pattern == '*')
306  pattern++;
307  return !*pattern;
308 }
NULL
#define NULL
Definition: catime.c:38
str
#define str(v)
Definition: iocshRegisterCommon.c:26
LIBCOM_API unsigned int epicsStrHash ( const char *  str,
unsigned int  seed 
)

Definition at line 356 of file epicsString.c.

357 {
358  unsigned int hash = seed;
359  char c;
360 
361  while ((c = *str++)) {
362  hash ^= ~((hash << 11) ^ c ^ (hash >> 5));
363  if (!(c = *str++)) break;
364  hash ^= (hash << 7) ^ c ^ (hash >> 3);
365  }
366  return hash;
367 }
str
#define str(v)
Definition: iocshRegisterCommon.c:26
LIBCOM_API int epicsStrnCaseCmp ( const char *  s1,
const char *  s2,
size_t  len 
)

Definition at line 206 of file epicsString.c.

207 {
208  size_t i = 0;
209 
210  while (i++ < len) {
211  int ch1 = toupper((int) *s1);
212  int ch2 = toupper((int) *s2);
213 
214  if (ch2 == 0) return (ch1 != 0);
215  if (ch1 == 0) return -1;
216  if (ch1 < ch2) return -1;
217  if (ch1 > ch2) return 1;
218  s1++;
219  s2++;
220  }
221  return 0;
222 }
i
int i
Definition: scan.c:967
LIBCOM_API char* epicsStrnDup ( const char *  s,
size_t  len 
)

Definition at line 224 of file epicsString.c.

225 {
226  char *buf = mallocMustSucceed(len + 1, "epicsStrnDup");
227 
228  strncpy(buf, s, len);
229  buf[len] = '\0';
230  return buf;
231 }
mallocMustSucceed
LIBCOM_API void * mallocMustSucceed(size_t size, const char *msg)
A malloc() that never returns NULL.
Definition: cantProceed.c:38
LIBCOM_API int epicsStrnEscapedFromRaw ( char *  outbuf,
size_t  outsize,
const char *  inbuf,
size_t  inlen 
)

Definition at line 129 of file epicsString.c.

131 {
132  int rem = dstlen;
133  int ndst = 0;
134 
135  if (dst == src)
136  return -1;
137 
138  while (srclen--) {
139  int c = *src++;
140  #define OUT(chr) ndst++; if (--rem > 0) *dst++ = chr
141 
142  switch (c) {
143  case '\a': OUT('\\'); OUT('a'); break;
144  case '\b': OUT('\\'); OUT('b'); break;
145  case '\f': OUT('\\'); OUT('f'); break;
146  case '\n': OUT('\\'); OUT('n'); break;
147  case '\r': OUT('\\'); OUT('r'); break;
148  case '\t': OUT('\\'); OUT('t'); break;
149  case '\v': OUT('\\'); OUT('v'); break;
150  case '\\': OUT('\\'); OUT('\\'); break;
151  case '\'': OUT('\\'); OUT('\''); break;
152  case '\"': OUT('\\'); OUT('\"'); break;
153  default:
154  if (isprint(c & 0xff)) {
155  OUT(c);
156  break;
157  }
158  OUT('\\');
159  OUT('0' + ((c & 0300) >> 6));
160  OUT('0' + ((c & 0070) >> 3));
161  OUT('0' + (c & 0007));
162  }
163  #undef OUT
164  }
165  if (dstlen)
166  *dst = '\0';
167  return ndst;
168 }
OUT
#define OUT(chr)
LIBCOM_API size_t epicsStrnEscapedFromRawSize ( const char *  buf,
size_t  len 
)

Definition at line 170 of file epicsString.c.

171 {
172  size_t ndst = srclen;
173 
174  while (srclen--) {
175  int c = *src++;
176 
177  switch (c) {
178  case '\a': case '\b': case '\f': case '\n':
179  case '\r': case '\t': case '\v': case '\\':
180  case '\'': case '\"':
181  ndst++;
182  break;
183  default:
184  if (!isprint(c & 0xff))
185  ndst += 3;
186  }
187  }
188  return ndst;
189 }
LIBCOM_API size_t epicsStrnLen ( const char *  s,
size_t  maxlen 
)

Definition at line 268 of file epicsString.c.

269 {
270  size_t i;
271 
272  for (i=0; i<maxlen; i++) {
273  if(s[i]=='\0')
274  return i;
275  }
276  return i;
277 }
i
int i
Definition: scan.c:967
LIBCOM_API int epicsStrnRawFromEscaped ( char *  outbuf,
size_t  outsize,
const char *  inbuf,
size_t  inlen 
)

Definition at line 37 of file epicsString.c.

39 {
40  int rem = dstlen;
41  int ndst = 0;
42 
43  while (srclen--) {
44  int c = *src++;
45  #define OUT(chr) if (--rem > 0) ndst++, *dst++ = chr
46 
47  if (!c) break;
48 
49  input:
50  if (c != '\\') {
51  OUT(c);
52  continue;
53  }
54 
55  if (!srclen-- || !(c = *src++)) break;
56 
57  switch (c) {
58  case 'a': OUT('\a'); break;
59  case 'b': OUT('\b'); break;
60  case 'f': OUT('\f'); break;
61  case 'n': OUT('\n'); break;
62  case 'r': OUT('\r'); break;
63  case 't': OUT('\t'); break;
64  case 'v': OUT('\v'); break;
65  case '\\': OUT('\\'); break;
66  case '\'': OUT('\''); break;
67  case '\"': OUT('\"'); break;
68 
69  case '0' :case '1' :case '2' :case '3' :
70  case '4' :case '5' :case '6' :case '7' :
71  { /* \ooo */
72  unsigned int u = c - '0';
73 
74  if (!srclen-- || !(c = *src++)) {
75  OUT(u); goto done;
76  }
77  if (c < '0' || c > '7') {
78  OUT(u); goto input;
79  }
80  u = u << 3 | (c - '0');
81 
82  if (!srclen-- || !(c = *src++)) {
83  OUT(u); goto done;
84  }
85  if (c < '0' || c > '7') {
86  OUT(u); goto input;
87  }
88  u = u << 3 | (c - '0');
89 
90  if (u > 0377) {
91  /* Undefined behaviour! */
92  }
93  OUT(u);
94  }
95  break;
96 
97  case 'x' :
98  { /* \xXXX... */
99  unsigned int u = 0;
100 
101  if (!srclen-- || !(c = *src++ & 0xff))
102  goto done;
103 
104  while (isxdigit(c)) {
105  u = u << 4 | ((c > '9') ? toupper(c) - 'A' + 10 : c - '0');
106  if (u > 0xff) {
107  /* Undefined behaviour! */
108  }
109  if (!srclen-- || !(c = *src++ & 0xff)) {
110  OUT(u);
111  goto done;
112  }
113  }
114  OUT(u);
115  goto input;
116  }
117 
118  default:
119  OUT(c);
120  }
121  #undef OUT
122  }
123 done:
124  if (dstlen)
125  *dst = '\0';
126  return ndst;
127 }
done
void done(int k)
Definition: antelope.c:77
OUT
#define OUT(chr)
LIBCOM_API int epicsStrPrintEscaped ( FILE *  fp,
const char *  s,
size_t  n 
)

Definition at line 238 of file epicsString.c.

239 {
240  int nout = 0;
241 
242  while (len--) {
243  char c = *s++;
244 
245  switch (c) {
246  case '\a': nout += fprintf(fp, "\\a"); break;
247  case '\b': nout += fprintf(fp, "\\b"); break;
248  case '\f': nout += fprintf(fp, "\\f"); break;
249  case '\n': nout += fprintf(fp, "\\n"); break;
250  case '\r': nout += fprintf(fp, "\\r"); break;
251  case '\t': nout += fprintf(fp, "\\t"); break;
252  case '\v': nout += fprintf(fp, "\\v"); break;
253  case '\\': nout += fprintf(fp, "\\\\"); break;
254  case '\'': nout += fprintf(fp, "\\'"); break;
255  case '\"': nout += fprintf(fp, "\\\""); break;
256  default:
257  if (isprint(0xff & (int)c))
258  nout += fprintf(fp, "%c", c);
259  else
260  nout += fprintf(fp, "\\%03o", (unsigned char)c);
261  break;
262  }
263  }
264  return nout;
265 }
LIBCOM_API char* epicsStrtok_r ( char *  s,
const char *  delim,
char **  lasts 
)

Definition at line 310 of file epicsString.c.

311 {
312  const char *spanp;
313  int c, sc;
314  char *tok;
315 
316  if (s == NULL && (s = *lasts) == NULL)
317  return NULL;
318 
319  /*
320  * Skip (span) leading delimiters (s += strspn(s, delim), sort of).
321  */
322 cont:
323  c = *s++;
324  for (spanp = delim; (sc = *spanp++) != 0;) {
325  if (c == sc)
326  goto cont;
327  }
328 
329  if (c == 0) { /* no non-delimiter characters */
330  *lasts = NULL;
331  return NULL;
332  }
333  tok = s - 1;
334 
335  /*
336  * Scan token (scan for delimiters: s += strcspn(s, delim), sort of).
337  * Note that delim must have one NUL; we stop if we see that, too.
338  */
339  for (;;) {
340  c = *s++;
341  spanp = delim;
342  do {
343  if ((sc = *spanp++) == c) {
344  if (c == 0)
345  s = NULL;
346  else
347  s[-1] = 0;
348  *lasts = s;
349  return tok;
350  }
351  } while (sc != 0);
352  }
353 }
NULL
#define NULL
Definition: catime.c:38