File: stringhelper.h

package info (click to toggle)
grok 1.20110708.1-4.3
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 2,460 kB
  • sloc: ansic: 3,469; ruby: 987; makefile: 276; sh: 124; yacc: 106
file content (51 lines) | stat: -rw-r--r-- 1,863 bytes parent folder | download | duplicates (5)
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
/**
 * @file stringhelper.h
 */
#ifndef _STRINGHELPER_H_ 
#define  _STRINGHELPER_H_ 

/**
 * substring replacement.
 *
 * This function handles growing the string if the new length would be 
 * longer than the alloc size.
 *
 * @param strp pointer to the string you want to modify
 * @param strp_len pointer to current length of the string. If negative, I will
 *        use strlen() to calculate the length myself.
 * @param strp_alloc_size pointer to current allocated size of string
 * @param start start position of the replacement. 0 offset. If negative, it is an offset
 *        against the end of the string; -1 for end of string.
 * @param end end position of the replacement. If negative, it is an offset
 *        against the end of the string; -1 for end of string. If zero (0),
 *        then end is set to start.
 * @param replace string to replace with
 * @param replace_len length of the replacement string
 */
void substr_replace(char **strp, int *strp_len, int *strp_alloc_size,
                    const int start, const int end, 
                    const char *replace, const int replace_len);

#define ESCAPE_LIKE_C 0x0001
#define ESCAPE_UNICODE 0x0002
#define ESCAPE_HEX 0x0004
#define ESCAPE_NONPRINTABLE 0x0008

/**
 * Escape a string by specific options.
 *
 * This function will 
 * @param strp pointer to string to escape
 */
void string_escape(char **strp, int *strp_len, int *strp_alloc_size,
                   const char *chars, int chars_len, int options);
void string_unescape(char **strp, int *strp_len, int *strp_size);

int string_count(const char *src, const char *charlist);
int string_ncount(const char *src, size_t srclen,
                  const char *charlist, size_t listlen);

/* libc doesn't often have strndup, so let's make our own */
char *string_ndup(const char *src, size_t size);

#endif /* _STRINGHELPER_H_ */