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
|
/** \file
* \brief String Utilities
*
* See Copyright Notice in "iup.h"
*/
#ifndef __IUP_STR_H
#define __IUP_STR_H
#ifdef __cplusplus
extern "C" {
#endif
/** \defgroup str String Utilities
* \par
* See \ref iup_str.h
* \ingroup util */
/** Returns a copy of the given string.
* If str is NULL it will return NULL.
* \ingroup str */
char* iupStrDup(const char* str);
/** Returns a non zero value if the two strings are equal.
* str1 or str2 can be NULL.
* \ingroup str */
int iupStrEqual(const char* str1, const char* str2);
/** Returns a non zero value if the two strings are equal but ignores case.
* str1 or str2 can be NULL.
* \ingroup str */
int iupStrEqualNoCase(const char* str1, const char* str2);
/** Returns a non zero value if the two strings are equal
* up to a number of characters defined by the strlen of the second string.
* str1 or str2 can be NULL.
* \ingroup str */
int iupStrEqualPartial(const char* str1, const char* str2);
/** Returns 1 if the string is "1", "YES", "ON" or "TRUE". \n
* Returns 0 if the string is "0", "NO", "OFF" or "FALSE", or the string is NULL or empty.
* \ingroup str */
int iupStrBoolean(const char* str);
/** Returns the number of lines in a string.
* It works for UNIX, DOS and MAC line ends.
* \ingroup str */
int iupStrLineCount(const char* str);
/** Returns the a pointer to the next line and the size of the current line.
* It works for UNIX, DOS and MAC line ends. The size does not includes the line end.
* If str is NULL it will return NULL.
* \ingroup str */
const char* iupStrNextLine(const char* str, int *len);
/** Returns the number of repetitions of the character occours in the string.
* \ingroup str */
int iupStrCountChar(const char *str, int c);
/** Returns a new string containing a copy of the string up to the character.
* The string is then incremented to after the position of the character.
* \ingroup str */
char *iupStrCopyUntil(char **str, int c);
/** Copy the string to the buffer, but limited to the max_size of the buffer.
* buffer is always porperly ended.
* \ingroup str */
void iupStrCopyN(char* dst_str, int dst_max_size, const char* src_str);
/** Returns a buffer with the specified size+1. \n
* The buffer is resused after 50 calls. It must NOT be freed.
* Use size=-1 to free all the internal buffers.
* \ingroup str */
char *iupStrGetMemory(int size);
/** Returns a buffer that contains a copy of the given buffer using \ref iupStrGetMemory.
* \ingroup str */
char *iupStrGetMemoryCopy(const char* str);
/** Converts a string into lower case.
* \ingroup str */
void iupStrLower(char* dstr, const char* sstr);
/** Extract a RGB triple from the string. Returns 0 or 1.
* \ingroup str */
int iupStrToRGB(const char *str, unsigned char *r, unsigned char *g, unsigned char *b);
/** Extract a RGBA quad from the string, alpha is optional. Returns 0, 3 or 4.
* \ingroup str */
int iupStrToRGBA(const char *str, unsigned char *r, unsigned char *g, unsigned char *b, unsigned char *a);
/** Converts the string to an int. The string must contains only the integer value.
* Returns a a non zero value if sucessfull.
* \ingroup str */
int iupStrToInt(const char *str, int *i);
/** Converts the string to two int. The string must contains two integer values in sequence,
* separated by the given character (usually 'x' or ':').
* Returns the number of converted values.
* Values not extracted are not changed.
* \ingroup str */
int iupStrToIntInt(const char *str, int *i1, int *i2, char sep);
/** Converts the string to an float. The string must contains only the real value.
* Returns a a non zero value if sucessfull.
* \ingroup str */
int iupStrToFloat(const char *str, float *f);
/** Converts the string to two float. The string must contains two real values in sequence,
* separated by the given character (usually 'x' or ':').
* Returns the number of converted values.
* Values not extracted are not changed.
* \ingroup str */
int iupStrToFloatFloat(const char *str, float *f1, float *f2, char sep);
/** Extract two strings from the string.
* separated by the given character (usually 'x' or ':').
* Returns the number of converted values.
* Values not extracted are not changed.
* \ingroup str */
int iupStrToStrStr(const char *str, char *str1, char *str2, char sep);
/** Returns the file extension of a file name.
* Supports UNIX and Windows directory separators.
* \ingroup str */
char* iupStrFileGetExt(const char *file_name);
/** Returns the file title of a file name.
* Supports UNIX and Windows directory separators.
* \ingroup str */
char* iupStrFileGetTitle(const char *file_name);
/** Returns the file path of a file name.
* Supports UNIX and Windows directory separators.
* \ingroup str */
char* iupStrFileGetPath(const char *file_name);
/** Concat path and title addind '/' between if path does not have it.
* \ingroup str */
char* iupStrFileMakeFileName(const char* path, const char* title);
/** Replace a character in a string.
* Returns the number of occurrences.
* \ingroup str */
int iupStrReplace(char* str, char src, char dst);
/** Convert line ends to UNIX format in place (one \n per line).
* \ingroup str */
void iupStrToUnix(char* str);
/** Convert line ends to MAC format in place (one \r per line).
* \ingroup str */
void iupStrToMac(char* str);
/** Convert line ends to DOS/Windows format (the sequence \r\n per line).
* If returned pointer different than input it must be freed.
* \ingroup str */
char* iupStrToDos(const char* str);
/** Remove the interval from the string. Done in place.
* \ingroup str */
void iupStrRemove(char* value, int start, int end, int dir);
/** Remove the interval from the string and insert the new string at the start.
* \ingroup str */
char* iupStrInsert(const char* value, const char* insert_value, int start, int end);
/** Process the mnemonic in the string. If not found returns str.
* If found returns a new string. Action can be:
- 1: replace & by c
- -1: remove & and return in c
- 0: remove &
* \ingroup str */
char* iupStrProcessMnemonic(const char* str, char *c, int action);
#ifdef __cplusplus
}
#endif
#endif
|
