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
183
184
|
/* xbstring.h
XBase64 Software Library
Copyright (c) 1997,2003,2014,2022 Gary A Kunkel
The xb64 software library is covered under the terms of the GPL Version 3, 2007 license.
Email Contact:
XDB-devel@lists.sourceforge.net
XDB-users@lists.sourceforge.net
*/
#ifndef __XBSTRING_H__
#define __XBSTRING_H__
#ifdef CMAKE_COMPILER_IS_GNUCC
#pragma interface
#endif
#include <stdlib.h>
#include <iostream>
namespace xb{
//! @brief Class for handling string data.
/*!
This class defines a basic string class with all the functions one would expect in a string class.
For purposes of the xbString class, a string is defined as a variable sized array of one byte
characters terminated with a null (0x00 or \0) byte.<br><br>
This version of the xbString class does not support wide (wchar_t) characters. Perhaps you would
be interested in creating a class for supporting wide characters.<br><br>
This string class handle strings in a 1-based (not 0 based) fashion.
Any string routines taking an offset use a 1-based value. That is, the first position of
the string is position 1, not 0.<br><br>
Position 1 (not 0) is considered the first position in a string.
A return of 0 would indicate a not found condition. A return of 1, would be the
first byte.
*/
class XBDLLEXPORT xbString {
public:
//Various constructors
xbString(xbUInt32 size);
xbString(char c);
xbString(const char *s, xbUInt32 lMaxLen);
xbString(const xbString &s);
xbString(const char * = "");
xbString( xbDouble d );
~xbString();
//operators
xbString &operator= (const xbString &s);
xbString &operator= (const char *s);
operator const char *() const;
char &operator[](xbUInt32 n) const;
char &operator[](xbInt32 n) const;
xbString &operator+=(const xbString &s);
xbString &operator+=(const char *s);
xbString &operator+=(char c);
xbString &operator-=(const xbString &s);
xbString &operator-=(const char *s);
xbString &operator-=(char c);
xbBool operator == ( const xbString& ) const;
xbBool operator == ( const char * ) const;
xbBool operator != ( const xbString& ) const;
xbBool operator != ( const char * ) const;
xbBool operator < ( const xbString& ) const;
xbBool operator > ( const xbString& ) const;
xbBool operator <= ( const xbString& ) const;
xbBool operator >= ( const xbString& ) const;
xbString operator-( const xbString &s );
xbString operator+( const char *s );
xbString operator+( const xbString &s );
xbString operator+( const char c );
xbString &AddBackSlash( char c );
xbString &Append(const xbString &s);
xbString &Append(const char *s);
xbString &Append(const char *s, xbUInt32 iByteCount );
xbString &Append(char c);
xbString &Assign(const char *srcStr, xbUInt32 lStartPos, xbUInt32 lCopyLen );
xbString &Assign(const char *srcStr, xbUInt32 lStartPos );
xbString &Assign(const xbString &s, xbUInt32 pos, xbUInt32 lCopyLen );
xbString &Assign(const xbString &s, xbUInt32 lCopyLen );
xbString Copy() const;
xbUInt32 CountChar( char c ) const;
xbUInt32 CountChar( char c, xbInt16 iOpt ) const;
xbInt16 CvtHexChar( char &cOut );
xbInt16 CvtHexString( xbString &sOut );
xbInt16 CvtULongLong( xbUInt64 &ullOut );
xbInt16 CvtLongLong( xbInt64 &llOut );
#ifdef XB_DEBUG_SUPPORT
void Dump( const char *title ) const;
void Dump( const char *title, xbInt16 iOption ) const;
void DumpHex( const char *title ) const;
#endif
xbString &ExtractElement(const char *src, char delim, xbUInt32 iCnt, xbInt16 iOpt = 0 );
char GetCharacter( xbUInt32 lPos ) const;
xbUInt32 GetLastPos(char c) const;
xbUInt32 GetLastPos(const char *s) const;
char GetPathSeparator() const;
xbUInt32 GetSize() const;
xbBool HasAlphaChars() const;
xbBool IsEmpty() const;
xbBool IsNull() const;
xbString &Left( xbUInt32 ulLen );
xbUInt32 Len() const; // returns the length of the string
xbString &Ltrim();
xbString &Ltrunc( xbUInt32 ulCnt );
xbString &Mid(xbUInt32 ulPos, xbUInt32 lLen );
xbString &PadLeft( char c, xbUInt32 ulLen );
xbString &PadRight( char c, xbUInt32 ulLen );
xbUInt32 Pos(char c) const;
xbUInt32 Pos(const char *s) const;
xbString &PutAt(xbUInt32 ulPos, char c);
xbString &Remove( xbUInt32 ulPos, xbUInt32 ulN );
xbString &Replace( const char *sReplace, const char *sReplaceWith, xbInt16 iOpt = 0 );
xbString &Resize( xbUInt32 lSize );
xbString &Rtrim();
xbString &Set( const char *s );
xbString &Set( const xbString &s );
xbString &Set( const char *s, xbUInt32 ulSize );
xbString &SetNum( xbInt32 lNum );
xbString &Sprintf(const char *format, ...);
const char *Str() const;
char *strncpy( char * cDest, xbUInt32 n ) const;
xbString &SwapChars( char from, char to );
xbString &ToLowerCase();
xbString &ToUpperCase();
xbString &Trim();
xbBool ValidLogicalValue() const;
xbBool ValidNumericValue() const;
xbString &ZapChar( char c );
xbString &ZapLeadingChar( char c );
xbString &ZapTrailingChar( char c );
friend std::ostream& operator<< ( std::ostream& os, const xbString& s );
private:
static const char * NullString;
static char cJunkBuf;
char *data; // pointer to actual string data
xbUInt32 size; // size of string plus null terminating byte
void ctor(const char *s);
// xbUInt32 CalcSprintfBufSize(const char *format, ...);
// char * xb_realloc( char *pIn, xbUInt32 iLen );
// next routine could result in buffer over runs if used with improperly sized buffers
char * xb_strcpy ( char *target, const char *source);
};
} /* namespace */
#endif /* __XBSTRING_H__ */
|
