<html>
<head>
<link rel="stylesheet" href="page.css" type="text/css">
<title>fox-toolkit.org - Documentation</title>
</head>
<body bgcolor=#ffffff link=#990033 vlink=#990033 alink=#990033 text=#000000>
<font face='verdana,sans-serif' size=2 >
<!---- TOPIC TITLE WITH LOGO--->
<table border=0 cellpadding= cellspacing=2 width=100% ><tr><td><a href='http://www.fox-toolkit.org/doc.html'><img src='../art/foxlogo_small.jpg' border=0></a></td><td width=100% valign=bottom><font face='verdana,sans-serif' size=2 ><b>
<a class="qindex" href="index.html">Main Page</a> <a class="qindex" href="hierarchy.html">Class Hierarchy</a> <a class="qindex" href="classes.html">Alphabetical List</a> <a class="qindex" href="annotated.html">Compound List</a> <a class="qindex" href="files.html">File List</a> <a class="qindex" href="functions.html">Compound Members</a>
<br><img src='../art/line.gif' width=100% height=1></b></font></td></tr></table>
<p>
<!--- TOPIC TITLE WITH LOGO --->
<!-- Generated by Doxygen 1.3.3 -->
<h1>FXString.h</h1><div class="fragment"><pre>00001 <span class="comment">/********************************************************************************</span>
00002 <span class="comment">* *</span>
00003 <span class="comment">* S t r i n g O b j e c t *</span>
00004 <span class="comment">* *</span>
00005 <span class="comment">*********************************************************************************</span>
00006 <span class="comment">* Copyright (C) 1997,2004 by Jeroen van der Zijp. All Rights Reserved. *</span>
00007 <span class="comment">*********************************************************************************</span>
00008 <span class="comment">* This library is free software; you can redistribute it and/or *</span>
00009 <span class="comment">* modify it under the terms of the GNU Lesser General Public *</span>
00010 <span class="comment">* License as published by the Free Software Foundation; either *</span>
00011 <span class="comment">* version 2.1 of the License, or (at your option) any later version. *</span>
00012 <span class="comment">* *</span>
00013 <span class="comment">* This library is distributed in the hope that it will be useful, *</span>
00014 <span class="comment">* but WITHOUT ANY WARRANTY; without even the implied warranty of *</span>
00015 <span class="comment">* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *</span>
00016 <span class="comment">* Lesser General Public License for more details. *</span>
00017 <span class="comment">* *</span>
00018 <span class="comment">* You should have received a copy of the GNU Lesser General Public *</span>
00019 <span class="comment">* License along with this library; if not, write to the Free Software *</span>
00020 <span class="comment">* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. *</span>
00021 <span class="comment">*********************************************************************************</span>
00022 <span class="comment">* $Id: FXString.h,v 1.66 2004/02/08 17:17:34 fox Exp $ *</span>
00023 <span class="comment">********************************************************************************/</span>
00024 <span class="preprocessor">#ifndef FXSTRING_H</span>
00025 <span class="preprocessor"></span><span class="preprocessor">#define FXSTRING_H</span>
00026 <span class="preprocessor"></span>
00027 <span class="keyword">namespace </span>FX {
00028
00029 <span class="comment"></span>
00030 <span class="comment">/**</span>
00031 <span class="comment">* FXString provides essential string manipulation capabilities.</span>
00032 <span class="comment">*/</span>
<a name="l00033"></a><a class="code" href="classFX_1_1FXString.html">00033</a> <span class="keyword">class </span>FXAPI FXString {
00034 <span class="keyword">private</span>:
00035 FXchar* str;
00036 <span class="keyword">public</span>:
00037 <span class="keyword">static</span> <span class="keyword">const</span> FXchar null[];
00038 <span class="keyword">static</span> <span class="keyword">const</span> FXchar hex[17];
00039 <span class="keyword">static</span> <span class="keyword">const</span> FXchar HEX[17];
00040 <span class="keyword">public</span>:
00041 <span class="comment"></span>
00042 <span class="comment"> /// Create empty string</span>
00043 <span class="comment"></span> FXString();
00044 <span class="comment"></span>
00045 <span class="comment"> /// Copy construct</span>
00046 <span class="comment"></span> FXString(<span class="keyword">const</span> FXString& s);
00047 <span class="comment"></span>
00048 <span class="comment"> /// Construct and init</span>
00049 <span class="comment"></span> FXString(<span class="keyword">const</span> FXchar* s);
00050 <span class="comment"></span>
00051 <span class="comment"> /// Construct and init with substring</span>
00052 <span class="comment"></span> FXString(<span class="keyword">const</span> FXchar* s,FXint n);
00053 <span class="comment"></span>
00054 <span class="comment"> /// Construct and fill with constant</span>
00055 <span class="comment"></span> FXString(FXchar c,FXint n);
00056 <span class="comment"></span>
00057 <span class="comment"> /// Construct string from two parts</span>
00058 <span class="comment"></span> FXString(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXchar* s2);
00059 <span class="comment"></span>
00060 <span class="comment"> /// Change the length of the string to len</span>
00061 <span class="comment"></span> <span class="keywordtype">void</span> length(FXint len);
<a name="l00062"></a><a class="code" href="classFX_1_1FXString.html#a7">00062</a> <span class="comment"></span>
00063 <span class="comment"> /// Length of text</span>
00064 <span class="comment"></span> FXint length()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> ((FXint*)str)[-1]; }
<a name="l00065"></a><a class="code" href="classFX_1_1FXString.html#a8">00065</a> <span class="comment"></span>
00066 <span class="comment"> /// Get text contents</span>
00067 <span class="comment"></span> <span class="keyword">const</span> FXchar* text()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> (<span class="keyword">const</span> FXchar*)str; }
<a name="l00068"></a><a class="code" href="classFX_1_1FXString.html#a9">00068</a> <span class="comment"></span>
00069 <span class="comment"> /// See if string is empty</span>
00070 <span class="comment"></span> FXbool empty()<span class="keyword"> const </span>{ <span class="keywordflow">return</span> (((FXint*)str)[-1]==0); }
<a name="l00071"></a><a class="code" href="classFX_1_1FXString.html#a10">00071</a> <span class="comment"></span>
00072 <span class="comment"> /// Return a non-const reference to the ith character</span>
00073 <span class="comment"></span> FXchar& operator[](FXint i){ <span class="keywordflow">return</span> str[i]; }
<a name="l00074"></a><a class="code" href="classFX_1_1FXString.html#a11">00074</a> <span class="comment"></span>
00075 <span class="comment"> /// Return a const reference to the ith character</span>
00076 <span class="comment"></span> <span class="keyword">const</span> FXchar& operator[](FXint i)<span class="keyword"> const </span>{ <span class="keywordflow">return</span> str[i]; }
00077 <span class="comment"></span>
00078 <span class="comment"> /// Assign another string to this</span>
00079 <span class="comment"></span> FXString& operator=(<span class="keyword">const</span> FXString& s);
00080 <span class="comment"></span>
00081 <span class="comment"> /// Assign a C-style string to this</span>
00082 <span class="comment"></span> FXString& operator=(<span class="keyword">const</span> FXchar* s);
00083 <span class="comment"></span>
00084 <span class="comment"> /// Fill with a constant</span>
00085 <span class="comment"></span> FXString& fill(FXchar c,FXint n);
00086 <span class="comment"></span>
00087 <span class="comment"> /// Fill up to current length</span>
00088 <span class="comment"></span> FXString& fill(FXchar c);
00089 <span class="comment"></span>
00090 <span class="comment"> /// Convert to lower case</span>
00091 <span class="comment"></span> FXString& lower();
00092 <span class="comment"></span>
00093 <span class="comment"> /// Convert to upper case</span>
00094 <span class="comment"></span> FXString& upper();
00095 <span class="comment"></span>
00096 <span class="comment"> /// Return num partition(s) of string separated by delimiter delim</span>
00097 <span class="comment"></span> FXString section(FXchar delim,FXint start,FXint num=1) <span class="keyword">const</span>;
00098 <span class="comment"></span>
00099 <span class="comment"> /// Return num partition(s) of string separated by delimiters in delim</span>
00100 <span class="comment"></span> FXString section(<span class="keyword">const</span> FXchar* delim,FXint n,FXint start,FXint num=1) <span class="keyword">const</span>;
00101 <span class="comment"></span>
00102 <span class="comment"> /// Return num partition(s) of string separated by delimiters in delim</span>
00103 <span class="comment"></span> FXString section(<span class="keyword">const</span> FXchar* delim,FXint start,FXint num=1) <span class="keyword">const</span>;
00104 <span class="comment"></span>
00105 <span class="comment"> /// Return num partition(s) of string separated by delimiters in delim</span>
00106 <span class="comment"></span> FXString section(<span class="keyword">const</span> FXString& delim,FXint start,FXint num=1) <span class="keyword">const</span>;
00107 <span class="comment"></span>
00108 <span class="comment"> /// Assign character c to this string</span>
00109 <span class="comment"></span> FXString& assign(FXchar c);
00110 <span class="comment"></span>
00111 <span class="comment"> /// Assign n characters c to this string</span>
00112 <span class="comment"></span> FXString& assign(FXchar c,FXint n);
00113 <span class="comment"></span>
00114 <span class="comment"> /// Assign first n characters of string s to this string</span>
00115 <span class="comment"></span> FXString& assign(<span class="keyword">const</span> FXchar *s,FXint n);
00116 <span class="comment"></span>
00117 <span class="comment"> /// Assign string s to this string</span>
00118 <span class="comment"></span> FXString& assign(<span class="keyword">const</span> FXString& s);
00119 <span class="comment"></span>
00120 <span class="comment"> /// Assign string s to this string</span>
00121 <span class="comment"></span> FXString& assign(<span class="keyword">const</span> FXchar* s);
00122 <span class="comment"></span>
00123 <span class="comment"> /// Insert character at specified position</span>
00124 <span class="comment"></span> FXString& insert(FXint pos,FXchar c);
00125 <span class="comment"></span>
00126 <span class="comment"> /// Insert n characters c at specified position</span>
00127 <span class="comment"></span> FXString& insert(FXint pos,FXchar c,FXint n);
00128 <span class="comment"></span>
00129 <span class="comment"> /// Insert first n characters of string at specified position</span>
00130 <span class="comment"></span> FXString& insert(FXint pos,<span class="keyword">const</span> FXchar* s,FXint n);
00131 <span class="comment"></span>
00132 <span class="comment"> /// Insert string at specified position</span>
00133 <span class="comment"></span> FXString& insert(FXint pos,<span class="keyword">const</span> FXString& s);
00134 <span class="comment"></span>
00135 <span class="comment"> /// Insert string at specified position</span>
00136 <span class="comment"></span> FXString& insert(FXint pos,<span class="keyword">const</span> FXchar* s);
00137 <span class="comment"></span>
00138 <span class="comment"> /// Prepend string with input character</span>
00139 <span class="comment"></span> FXString& prepend(FXchar c);
00140 <span class="comment"></span>
00141 <span class="comment"> /// Prepend string with n characters c</span>
00142 <span class="comment"></span> FXString& prepend(FXchar c,FXint n);
00143 <span class="comment"></span>
00144 <span class="comment"> /// Prepend string with first n characters of input string</span>
00145 <span class="comment"></span> FXString& prepend(<span class="keyword">const</span> FXchar* s,FXint n);
00146 <span class="comment"></span>
00147 <span class="comment"> /// Prepend string with input string</span>
00148 <span class="comment"></span> FXString& prepend(<span class="keyword">const</span> FXString& s);
00149 <span class="comment"></span>
00150 <span class="comment"> /// Prepend string with input string</span>
00151 <span class="comment"></span> FXString& prepend(<span class="keyword">const</span> FXchar* s);
00152 <span class="comment"></span>
00153 <span class="comment"> /// Append input character to this string</span>
00154 <span class="comment"></span> FXString& append(FXchar c);
00155 <span class="comment"></span>
00156 <span class="comment"> /// Append input n characters c to this string</span>
00157 <span class="comment"></span> FXString& append(FXchar c,FXint n);
00158 <span class="comment"></span>
00159 <span class="comment"> /// Append first n characters of input string to this string</span>
00160 <span class="comment"></span> FXString& append(<span class="keyword">const</span> FXchar* s,FXint n);
00161 <span class="comment"></span>
00162 <span class="comment"> /// Append input string to this string</span>
00163 <span class="comment"></span> FXString& append(<span class="keyword">const</span> FXString& s);
00164 <span class="comment"></span>
00165 <span class="comment"> /// Append input string to this string</span>
00166 <span class="comment"></span> FXString& append(<span class="keyword">const</span> FXchar* s);
00167 <span class="comment"></span>
00168 <span class="comment"> /// Replace a single character</span>
00169 <span class="comment"></span> FXString& replace(FXint pos,FXchar c);
00170 <span class="comment"></span>
00171 <span class="comment"> /// Replace the m characters at pos with n characters c</span>
00172 <span class="comment"></span> FXString& replace(FXint pos,FXint m,FXchar c,FXint n);
00173 <span class="comment"></span>
00174 <span class="comment"> /// Replaces the m characters at pos with first n characters of input string</span>
00175 <span class="comment"></span> FXString& replace(FXint pos,FXint m,<span class="keyword">const</span> FXchar* s,FXint n);
00176 <span class="comment"></span>
00177 <span class="comment"> /// Replace the m characters at pos with input string</span>
00178 <span class="comment"></span> FXString& replace(FXint pos,FXint m,<span class="keyword">const</span> FXString& s);
00179 <span class="comment"></span>
00180 <span class="comment"> /// Replace the m characters at pos with input string</span>
00181 <span class="comment"></span> FXString& replace(FXint pos,FXint m,<span class="keyword">const</span> FXchar* s);
00182 <span class="comment"></span>
00183 <span class="comment"> /// Remove substring</span>
00184 <span class="comment"></span> FXString& remove(FXint pos,FXint n=1);
00185 <span class="comment"></span>
00186 <span class="comment"> /// Return number of occurrences of ch in string</span>
00187 <span class="comment"></span> FXint contains(FXchar ch);
00188 <span class="comment"></span>
00189 <span class="comment"> /// Return number of occurrences of string sub in string</span>
00190 <span class="comment"></span> FXint contains(<span class="keyword">const</span> FXchar* sub,FXint n);
00191 <span class="comment"></span>
00192 <span class="comment"> /// Return number of occurrences of string sub in string</span>
00193 <span class="comment"></span> FXint contains(<span class="keyword">const</span> FXchar* sub);
00194 <span class="comment"></span>
00195 <span class="comment"> /// Return number of occurrences of string sub in string</span>
00196 <span class="comment"></span> FXint contains(<span class="keyword">const</span> FXString& sub);
00197 <span class="comment"></span>
00198 <span class="comment"> /// Substitute one character by another</span>
00199 <span class="comment"></span> FXString& substitute(FXchar org,FXchar sub,FXbool all=TRUE);
00200 <span class="comment"></span>
00201 <span class="comment"> /// Substitute one string by another</span>
00202 <span class="comment"></span> FXString& substitute(<span class="keyword">const</span> FXchar* org,FXint olen,<span class="keyword">const</span> FXchar *rep,FXint rlen,FXbool all=TRUE);
00203 <span class="comment"></span>
00204 <span class="comment"> /// Substitute one string by another</span>
00205 <span class="comment"></span> FXString& substitute(<span class="keyword">const</span> FXchar* org,<span class="keyword">const</span> FXchar *rep,FXbool all=TRUE);
00206 <span class="comment"></span>
00207 <span class="comment"> /// Substitute one string by another</span>
00208 <span class="comment"></span> FXString& substitute(<span class="keyword">const</span> FXString& org,<span class="keyword">const</span> FXString& rep,FXbool all=TRUE);
00209 <span class="comment"></span>
00210 <span class="comment"> /// Simplify whitespace in string</span>
00211 <span class="comment"></span> FXString& simplify();
00212 <span class="comment"></span>
00213 <span class="comment"> /// Remove leading and trailing whitespace</span>
00214 <span class="comment"></span> FXString& trim();
00215 <span class="comment"></span>
00216 <span class="comment"> /// Remove leading whitespace</span>
00217 <span class="comment"></span> FXString& trimBegin();
00218 <span class="comment"></span>
00219 <span class="comment"> /// Remove trailing whitespace</span>
00220 <span class="comment"></span> FXString& trimEnd();
00221 <span class="comment"></span>
00222 <span class="comment"> /// Truncate string at pos</span>
00223 <span class="comment"></span> FXString& trunc(FXint pos);
00224 <span class="comment"></span>
00225 <span class="comment"> /// Clear</span>
00226 <span class="comment"></span> FXString& clear();
00227 <span class="comment"></span>
00228 <span class="comment"> /// Get left most part</span>
00229 <span class="comment"></span> FXString left(FXint n) <span class="keyword">const</span>;
00230 <span class="comment"></span>
00231 <span class="comment"> /// Get right most part</span>
00232 <span class="comment"></span> FXString right(FXint n) <span class="keyword">const</span>;
00233 <span class="comment"></span>
00234 <span class="comment"> /// Get some part in the middle</span>
00235 <span class="comment"></span> FXString mid(FXint pos,FXint n) <span class="keyword">const</span>;
00236 <span class="comment"></span>
00237 <span class="comment"> /**</span>
00238 <span class="comment"> * Return all characters before the n-th occurrence of ch,</span>
00239 <span class="comment"> * searching from the beginning of the string. If the character</span>
00240 <span class="comment"> * is not found, return the entire string. If n<=0, return</span>
00241 <span class="comment"> * the empty string.</span>
00242 <span class="comment"> */</span>
00243 FXString before(FXchar ch,FXint n=1) <span class="keyword">const</span>;
00244 <span class="comment"></span>
00245 <span class="comment"> /**</span>
00246 <span class="comment"> * Return all characters before the n-th occurrence of ch,</span>
00247 <span class="comment"> * searching from the end of the string. If the character</span>
00248 <span class="comment"> * is not found, return the empty string. If n<=0, return</span>
00249 <span class="comment"> * the entire string.</span>
00250 <span class="comment"> */</span>
00251 FXString rbefore(FXchar ch,FXint n=1) <span class="keyword">const</span>;
00252 <span class="comment"></span>
00253 <span class="comment"> /**</span>
00254 <span class="comment"> * Return all characters after the nth occurrence of ch,</span>
00255 <span class="comment"> * searching from the beginning of the string. If the character</span>
00256 <span class="comment"> * is not found, return the empty string. If n<=0, return</span>
00257 <span class="comment"> * the entire string.</span>
00258 <span class="comment"> */</span>
00259 FXString after(FXchar ch,FXint n=1) <span class="keyword">const</span>;
00260 <span class="comment"></span>
00261 <span class="comment"> /**</span>
00262 <span class="comment"> * Return all characters after the nth occurrence of ch,</span>
00263 <span class="comment"> * searching from the end of the string. If the character</span>
00264 <span class="comment"> * is not found, return the entire string. If n<=0, return</span>
00265 <span class="comment"> * the empty string.</span>
00266 <span class="comment"> */</span>
00267 FXString rafter(FXchar ch,FXint n=1) <span class="keyword">const</span>;
00268 <span class="comment"></span>
00269 <span class="comment"> /// Find a character, searching forward; return position or -1</span>
00270 <span class="comment"></span> FXint find(FXchar c,FXint pos=0) <span class="keyword">const</span>;
00271 <span class="comment"></span>
00272 <span class="comment"> /// Find a character, searching backward; return position or -1</span>
00273 <span class="comment"></span> FXint rfind(FXchar c,FXint pos=2147483647) <span class="keyword">const</span>;
00274
00275 <span class="comment">// Find n-th occurrence of character, searching forward; return position or -1</span>
00276 FXint find(FXchar c,FXint pos,FXint n) <span class="keyword">const</span>;
00277
00278 <span class="comment">// Find n-th occurrence of character, searching backward; return position or -1</span>
00279 FXint rfind(FXchar c,FXint pos,FXint n) <span class="keyword">const</span>;
00280 <span class="comment"></span>
00281 <span class="comment"> /// Find a substring of length n, searching forward; return position or -1</span>
00282 <span class="comment"></span> FXint find(<span class="keyword">const</span> FXchar* substr,FXint n,FXint pos) <span class="keyword">const</span>;
00283 <span class="comment"></span>
00284 <span class="comment"> /// Find a substring of length n, searching backward; return position or -1</span>
00285 <span class="comment"></span> FXint rfind(<span class="keyword">const</span> FXchar* substr,FXint n,FXint pos) <span class="keyword">const</span>;
00286 <span class="comment"></span>
00287 <span class="comment"> /// Find a substring, searching forward; return position or -1</span>
00288 <span class="comment"></span> FXint find(<span class="keyword">const</span> FXchar* substr,FXint pos=0) <span class="keyword">const</span>;
00289 <span class="comment"></span>
00290 <span class="comment"> /// Find a substring, searching backward; return position or -1</span>
00291 <span class="comment"></span> FXint rfind(<span class="keyword">const</span> FXchar* substr,FXint pos=2147483647) <span class="keyword">const</span>;
00292 <span class="comment"></span>
00293 <span class="comment"> /// Find a substring, searching forward; return position or -1</span>
00294 <span class="comment"></span> FXint find(<span class="keyword">const</span> FXString& substr,FXint pos=0) <span class="keyword">const</span>;
00295 <span class="comment"></span>
00296 <span class="comment"> /// Find a substring, searching backward; return position or -1</span>
00297 <span class="comment"></span> FXint rfind(<span class="keyword">const</span> FXString& substr,FXint pos=2147483647) <span class="keyword">const</span>;
00298 <span class="comment"></span>
00299 <span class="comment"> /// Find first character in the set of size n, starting from pos; return position or -1</span>
00300 <span class="comment"></span> FXint find_first_of(<span class="keyword">const</span> FXchar* set,FXint n,FXint pos) <span class="keyword">const</span>;
00301 <span class="comment"></span>
00302 <span class="comment"> /// Find first character in the set, starting from pos; return position or -1</span>
00303 <span class="comment"></span> FXint find_first_of(<span class="keyword">const</span> FXchar* set,FXint pos=0) <span class="keyword">const</span>;
00304 <span class="comment"></span>
00305 <span class="comment"> /// Find first character in the set, starting from pos; return position or -1</span>
00306 <span class="comment"></span> FXint find_first_of(<span class="keyword">const</span> FXString& set,FXint pos=0) <span class="keyword">const</span>;
00307 <span class="comment"></span>
00308 <span class="comment"> /// Find first character, starting from pos; return position or -1</span>
00309 <span class="comment"></span> FXint find_first_of(FXchar c,FXint pos=0) <span class="keyword">const</span>;
00310 <span class="comment"></span>
00311 <span class="comment"> /// Find last character in the set of size n, starting from pos; return position or -1</span>
00312 <span class="comment"></span> FXint find_last_of(<span class="keyword">const</span> FXchar* set,FXint n,FXint pos) <span class="keyword">const</span>;
00313 <span class="comment"></span>
00314 <span class="comment"> /// Find last character in the set, starting from pos; return position or -1</span>
00315 <span class="comment"></span> FXint find_last_of(<span class="keyword">const</span> FXchar* set,FXint pos=2147483647) <span class="keyword">const</span>;
00316 <span class="comment"></span>
00317 <span class="comment"> /// Find last character in the set, starting from pos; return position or -1</span>
00318 <span class="comment"></span> FXint find_last_of(<span class="keyword">const</span> FXString& set,FXint pos=2147483647) <span class="keyword">const</span>;
00319 <span class="comment"></span>
00320 <span class="comment"> /// Find last character, starting from pos; return position or -1</span>
00321 <span class="comment"></span> FXint find_last_of(FXchar c,FXint pos=0) <span class="keyword">const</span>;
00322 <span class="comment"></span>
00323 <span class="comment"> /// Find first character NOT in the set of size n, starting from pos; return position or -1</span>
00324 <span class="comment"></span> FXint find_first_not_of(<span class="keyword">const</span> FXchar* set,FXint n,FXint pos) <span class="keyword">const</span>;
00325 <span class="comment"></span>
00326 <span class="comment"> /// Find first character NOT in the set, starting from pos; return position or -1</span>
00327 <span class="comment"></span> FXint find_first_not_of(<span class="keyword">const</span> FXchar* set,FXint pos=0) <span class="keyword">const</span>;
00328 <span class="comment"></span>
00329 <span class="comment"> /// Find first character NOT in the set, starting from pos; return position or -1</span>
00330 <span class="comment"></span> FXint find_first_not_of(<span class="keyword">const</span> FXString& set,FXint pos=0) <span class="keyword">const</span>;
00331 <span class="comment"></span>
00332 <span class="comment"> /// Find first character NOT equal to c, starting from pos; return position or -1</span>
00333 <span class="comment"></span> FXint find_first_not_of(FXchar c,FXint pos=0) <span class="keyword">const</span>;
00334 <span class="comment"></span>
00335 <span class="comment"> /// Find last character NOT in the set of size n, starting from pos; return position or -1</span>
00336 <span class="comment"></span> FXint find_last_not_of(<span class="keyword">const</span> FXchar* set,FXint n,FXint pos) <span class="keyword">const</span>;
00337 <span class="comment"></span>
00338 <span class="comment"> /// Find last character NOT in the set, starting from pos; return position or -1</span>
00339 <span class="comment"></span> FXint find_last_not_of(<span class="keyword">const</span> FXchar* set,FXint pos=2147483647) <span class="keyword">const</span>;
00340 <span class="comment"></span>
00341 <span class="comment"> /// Find last character NOT in the set, starting from pos; return position or -1</span>
00342 <span class="comment"></span> FXint find_last_not_of(<span class="keyword">const</span> FXString& set,FXint pos=2147483647) <span class="keyword">const</span>;
00343 <span class="comment"></span>
00344 <span class="comment"> /// Find last character NOT equal to c, starting from pos; return position or -1</span>
00345 <span class="comment"></span> FXint find_last_not_of(FXchar c,FXint pos=0) <span class="keyword">const</span>;
00346 <span class="comment"></span>
00347 <span class="comment"> /// Find number of occurrences of character in string</span>
00348 <span class="comment"></span> FXint count(FXchar c) <span class="keyword">const</span>;
00349 <span class="comment"></span>
00350 <span class="comment"> /// Format a string a-la printf</span>
00351 <span class="comment"></span> FXString& format(<span class="keyword">const</span> <span class="keywordtype">char</span>* fmt,...) FX_PRINTF(2,3) ;
00352 FXString& vformat(<span class="keyword">const</span> <span class="keywordtype">char</span>* fmt,va_list args);
00353 <span class="comment"></span>
00354 <span class="comment"> /// Scan a string a-la scanf</span>
00355 <span class="comment"></span> FXint scan(<span class="keyword">const</span> <span class="keywordtype">char</span>* fmt,...) <span class="keyword">const</span> FX_SCANF(2,3) ;
00356 FXint vscan(<span class="keyword">const</span> <span class="keywordtype">char</span>* fmt,va_list args) <span class="keyword">const</span>;
00357 <span class="comment"></span>
00358 <span class="comment"> /// Get hash value</span>
00359 <span class="comment"></span> FXuint hash() <span class="keyword">const</span>;
00360 <span class="comment"></span>
00361 <span class="comment"> /// Compare</span>
00362 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXchar* s2);
00363 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00364 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00365 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00366 <span class="comment"></span>
00367 <span class="comment"> /// Compare up to n</span>
00368 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXchar* s2,FXint n);
00369 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2,FXint n);
00370 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2,FXint n);
00371 <span class="keyword">friend</span> FXAPI FXint compare(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2,FXint n);
00372 <span class="comment"></span>
00373 <span class="comment"> /// Compare case insensitive</span>
00374 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXchar* s2);
00375 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00376 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00377 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00378 <span class="comment"></span>
00379 <span class="comment"> /// Compare case insensitive up to n</span>
00380 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXchar* s2,FXint n);
00381 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2,FXint n);
00382 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2,FXint n);
00383 <span class="keyword">friend</span> FXAPI FXint comparecase(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2,FXint n);
00384 <span class="comment"></span>
00385 <span class="comment"> /// Comparison operators</span>
00386 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXbool operator==(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00387 <span class="keyword">friend</span> FXAPI FXbool operator==(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00388 <span class="keyword">friend</span> FXAPI FXbool operator==(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00389
00390 <span class="keyword">friend</span> FXAPI FXbool operator!=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00391 <span class="keyword">friend</span> FXAPI FXbool operator!=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00392 <span class="keyword">friend</span> FXAPI FXbool operator!=(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00393
00394 <span class="keyword">friend</span> FXAPI FXbool operator<(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00395 <span class="keyword">friend</span> FXAPI FXbool operator<(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00396 <span class="keyword">friend</span> FXAPI FXbool operator<(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00397
00398 <span class="keyword">friend</span> FXAPI FXbool operator<=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00399 <span class="keyword">friend</span> FXAPI FXbool operator<=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00400 <span class="keyword">friend</span> FXAPI FXbool operator<=(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00401
00402 <span class="keyword">friend</span> FXAPI FXbool operator>(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00403 <span class="keyword">friend</span> FXAPI FXbool operator>(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00404 <span class="keyword">friend</span> FXAPI FXbool operator>(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00405
00406 <span class="keyword">friend</span> FXAPI FXbool operator>=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00407 <span class="keyword">friend</span> FXAPI FXbool operator>=(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00408 <span class="keyword">friend</span> FXAPI FXbool operator>=(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00409 <span class="comment"></span>
00410 <span class="comment"> /// Append operators</span>
00411 <span class="comment"></span> FXString& operator+=(<span class="keyword">const</span> FXString& s);
00412 FXString& operator+=(<span class="keyword">const</span> FXchar* s);
00413 FXString& operator+=(FXchar c);
00414 <span class="comment"></span>
00415 <span class="comment"> /// Concatenate two strings</span>
00416 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXString operator+(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXString& s2);
00417 <span class="keyword">friend</span> FXAPI FXString operator+(<span class="keyword">const</span> FXString& s1,<span class="keyword">const</span> FXchar* s2);
00418 <span class="keyword">friend</span> FXAPI FXString operator+(<span class="keyword">const</span> FXchar* s1,<span class="keyword">const</span> FXString& s2);
00419 <span class="comment"></span>
00420 <span class="comment"> /// Concatenate with single character</span>
00421 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXString operator+(<span class="keyword">const</span> FXString& s,FXchar c);
00422 <span class="keyword">friend</span> FXAPI FXString operator+(FXchar c,<span class="keyword">const</span> FXString& s);
00423 <span class="comment"></span>
00424 <span class="comment"> /// Saving to a stream</span>
00425 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXStream& operator<<(FXStream& store,<span class="keyword">const</span> FXString& s);
00426 <span class="comment"></span>
00427 <span class="comment"> /// Load from a stream</span>
00428 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXStream& operator>>(FXStream& store,FXString& s);
<a name="l00429"></a><a class="code" href="classFX_1_1FXString.html#a0">00429</a> <span class="comment"></span>
00430 <span class="comment"> /// Format a string a-la printf</span>
00431 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXString FXStringFormat(<span class="keyword">const</span> FXchar* fmt,...) FX_PRINTF(1,2) ;
00432 <span class="keyword">friend</span> FXAPI FXString FXStringVFormat(<span class="keyword">const</span> FXchar* fmt,va_list args);
00433 <span class="comment"></span>
00434 <span class="comment"> /**</span>
00435 <span class="comment"> * Convert integer number to a string, using the given number</span>
00436 <span class="comment"> * base, which must be between 2 and 16.</span>
00437 <span class="comment"> */</span>
00438 <span class="keyword">friend</span> FXAPI FXString FXStringVal(FXint num,FXint base=10);
00439 <span class="keyword">friend</span> FXAPI FXString FXStringVal(FXuint num,FXint base=10);
00440 <span class="comment"></span>
00441 <span class="comment"> /**</span>
00442 <span class="comment"> * Convert real number to a string, using the given procision and</span>
00443 <span class="comment"> * exponential notation mode, which may be FALSE (never), TRUE (always), or</span>
00444 <span class="comment"> * MAYBE (when needed).</span>
00445 <span class="comment"> */</span>
00446 <span class="keyword">friend</span> FXAPI FXString FXStringVal(FXfloat num,FXint prec=6,FXbool exp=MAYBE);
00447 <span class="keyword">friend</span> FXAPI FXString FXStringVal(FXdouble num,FXint prec=6,FXbool exp=MAYBE);
00448 <span class="comment"></span>
00449 <span class="comment"> /// Convert string to a integer number, assuming given number base</span>
00450 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXint FXIntVal(<span class="keyword">const</span> FXString& s,FXint base=10);
00451 <span class="keyword">friend</span> FXAPI FXuint FXUIntVal(<span class="keyword">const</span> FXString& s,FXint base=10);
00452 <span class="comment"></span>
00453 <span class="comment"> /// Convert string into real number</span>
00454 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXfloat FXFloatVal(<span class="keyword">const</span> FXString& s);
00455 <span class="keyword">friend</span> FXAPI FXdouble FXDoubleVal(<span class="keyword">const</span> FXString& s);
00456 <span class="comment"></span>
00457 <span class="comment"> /// Escape special characters in a string</span>
00458 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXString escape(<span class="keyword">const</span> FXString& s);
00459 <span class="comment"></span>
00460 <span class="comment"> /// Unescape special characters in a string</span>
00461 <span class="comment"></span> <span class="keyword">friend</span> FXAPI FXString unescape(<span class="keyword">const</span> FXString& s);
<a name="l00462"></a><a class="code" href="classFX_1_1FXString.html#n53">00462</a> <span class="comment"></span>
00463 <span class="comment"> /// Swap two strings</span>
00464 <span class="comment"></span> <span class="keyword">friend</span> FXAPI <span class="keywordtype">void</span> swap(FXString& a,FXString& b){ FXchar *t=a.str; a.str=b.str; b.str=t; }
00465 <span class="comment"></span>
00466 <span class="comment"> /// Delete</span>
00467 <span class="comment"></span> ~FXString();
00468 };
00469
00470
00471 }
00472
00473 <span class="preprocessor">#endif</span>
</pre></div></font>
<!--- COPYRIGHT -->
<p>
<table width=100% cellpadding=0 cellspacing=0><tr><td width=100% valign=top id=HEADLINE align=right>
<img src='../art/line.gif' width=100% height=1><font size=-1>
Copyright © 1997-2004 Jeroen van der Zijp</font>
</td></tr></table>
</p>
<!--- COPYRIGHT -->
</body>
</html>
