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
|
/*
Copyright (C) CFEngine AS
This file is part of CFEngine 3 - written and maintained by CFEngine AS.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; version 3.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
To the extent this program is licensed as part of the Enterprise
versions of CFEngine, the applicable Commercial Open Source License
(COSL) may apply to this file if you as a licensee so wish it. See
included file COSL.txt.
*/
#ifndef CFENGINE_STRING_LIB_H
#define CFENGINE_STRING_LIB_H
#include <platform.h>
#include <compiler.h>
#include <sequence.h>
#include <pcre_include.h>
typedef struct
{
const char *data;
size_t len;
} StringRef;
unsigned int StringHash(const char *str, unsigned int seed, unsigned int max);
char ToLower(char ch);
char ToUpper(char ch);
void ToUpperStrInplace(char *str);
void ToLowerStrInplace(char *str);
long StringToLong(const char *str);
char *StringFromLong(long number);
double StringToDouble(const char *str);
char *StringFromDouble(double number);
char *NULLStringToEmpty(char *str);
bool StringIsNumeric(const char *name);
bool StringIsPrintable(const char *name);
bool EmptyString(const char *s);
size_t StringBytesToHex(char *dst, size_t dst_size,
const unsigned char *src_bytes, size_t src_len);
char *SafeStringDuplicate(const char *str);
int SafeStringLength(const char *str);
int StringSafeCompare(const char *a, const char *b);
bool StringSafeEqual(const char *a, const char *b);
char *StringConcatenate(size_t count, const char *first, ...);
char *StringSubstring(const char *source, size_t source_len, int start, int len);
/* Allocates the result */
char *SearchAndReplace(const char *source, const char *search, const char *replace);
bool ReplaceStr(const char *in, char *out, int outSz, const char *from, const char *to);
bool IsStrIn(const char *str, const char *const strs[]);
bool IsStrCaseIn(const char *str, const char *const strs[]);
size_t StringCountTokens(const char *str, size_t len, const char *seps);
StringRef StringGetToken(const char *str, size_t len, size_t index, const char *seps);
char **String2StringArray(const char *str, char separator);
void FreeStringArray(char **strs);
int CountChar(const char *string, char sp);
void ReplaceChar(char *in, char *out, int outSz, char from, char to);
void ReplaceTrailingChar(char *str, char from, char to);
char *EscapeCharCopy(const char *str, char to_escape, char escape_with);
int StringInArray(char **array, char *string);
char *ScanPastChars(char *scanpast, char *input);
/**
* @brief Strips the newline character off a string, in place
* @param str The string to strip
* @param max_length Maximum length of input string
* @return 0 if successful, -1 if the input string was longer than allowed (max_length).
*/
int StripTrailingNewline(char *str, size_t max_length);
/**
* @brief Remove trailing spaces
* @param str
* @param max_length Maximum length of input string
* @return 0 if successful, -1 if Chop was called on a string that seemed to have no terminator
*/
int Chop(char *str, size_t max_length);
/**
* @brief Check if a string ends with the given suffix
* @param str
* @param suffix
* @return True if suffix matches
*/
bool StringEndsWith(const char *str, const char *suffix);
/**
* @brief Check if a string starts with the given prefix
* @param str
* @param prefix
* @return True if prefix matches
*/
bool StringStartsWith(const char *str, const char *prefix);
/**
* @brief Format string like vsprintf and return formatted string allocated
* on heap as a return value.
*/
char *StringVFormat(const char *fmt, va_list ap);
/**
* @brief Format string like sprintf and return formatted string allocated on
* heap as a return value.
*
* @param format Formatting string
* @return formatted string (on heap) or NULL in case of error. errno is set in
* the latter case (see errno codes for sprintf).
*/
char *StringFormat(const char *fmt, ...) FUNC_ATTR_PRINTF(1, 2);
/**
* @brief Find the initial segment of memory (up to #n bytes) consisting of character #c.
*
* @return first byte which is not #c, or #mem + #n if all bytes in memory segment are #c
*/
void *MemSpan(const void *mem, char c, size_t n);
/**
* @brief Find the initial segment of memory (up to #n bytes) consisting not of character #c.
*
* @return first byte which is #c, or #mem + #n if none of bytes in memory segment are #c
*/
void *MemSpanInverse(const void *mem, char c, size_t n);
bool StringNotMatchingSetCapped(const char *isp, int limit,
const char *exclude, char *obuf);
/**
* @brief Appends src to dst, but will not exceed n bytes in dst, including the terminating null.
* @param dst Destination string.
* @param src Source string.
* @param n Total size of dst buffer. The string will be truncated if this is exceeded.
* @return True if append was successful, false if the operation caused an overflow.
*/
bool StringAppend(char *dst, const char *src, size_t n);
#endif
|
