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
|
/* $Id: strutil.h,v 1.3 2004/11/04 21:25:17 graziano Exp $ */
#ifndef STRUTIL_H
#define STRUTIL_H
/*
** This module defines some useful routines for maniputing strings.
*/
#include <string.h> /* strlen() strncpy() */
#include <sys/types.h> /* size_t */
#ifdef __cplusplus
extern "C" {
#endif
/*
* Replaces the characters in #string# with their lower- or upper-case
* equivalents. #toWhatCase# specifies whether the result to be ENTIRELY
* UPPER, entirely lower, iNITIAL lOWER, or Initial Upper.
*/
typedef enum {ALL_LOWER, ALL_UPPER, INITIAL_LOWER, INITIAL_UPPER} CaseTypes;
void
strcase(char *string,
CaseTypes toWhatCase);
/*
** Returns 1 or 0 depending on whether or not the first #len# characters of
** #string# matches #pattern#, which may contain wildcard characters (*).
*/
int
strnmatch(const char *string,
const char *pattern,
size_t len);
#define strmatch(string,pattern) strnmatch(string, pattern, strlen(string))
/*
** Copies a "token" -- a series of characters deliminated by one of the chars
** in #delim# -- from #source# to the #len#-long string #dest#. Terminates
** #dest# with a null character. Returns the position within #source# of the
** character after the token in #end#. Skips any leading delimiters in
** #source#. Returns 0 if the end of source is reached without finding any
** non-delimiter characters, 1 otherwise.
*/
int
strntok(char *dest,
const char *source,
int len,
const char *delim,
const char **end);
#define GETTOK(dest,source,delim,end) strntok(dest,source,sizeof(dest),delim,end)
#define GETWORD(dest,source,end) GETTOK(dest,source," \t\n",end)
/*
* Define strnlen in case there is no such a function in the library
* (sometimes there is not the definition in the include so we define it
* anyway).
*/
size_t
strnlen(const char *s, size_t maxlen);
/*
** Calls strncpy() passing #dest#, #src#, and #len#, then places a terminating
** character in the last (len - 1) byte of #dest#.
*/
#define zstrncpy(dest,src,len) \
do {strncpy(dest, src, len); dest[len - 1] = '\0'; if (1) break;} while (0)
#define SAFESTRCPY(dest,src) zstrncpy(dest, src, sizeof(dest))
/*
** Catenates the #count#-long set of source strings into #dest#. Copies at
** most #len# characters, including the null terminator.
*/
int
vstrncpy(char *dest,
size_t len,
int count,
...);
#ifdef __cplusplus
}
#endif
#endif
|
