// find first n characters of sz
size_t find(const char* sz, size_t nStart = 0, size_t n = npos) const;
- // find the first occurence of character ch after nStart
+ // find the first occurrence of character ch after nStart
size_t find(char ch, size_t nStart = 0) const;
// rfind() family is exactly like find() but works right to left
// as find, but from the end
size_t rfind(char ch, size_t nStart = npos) const;
- // find first/last occurence of any character in the set
+ // find first/last occurrence of any character in the set
//
size_t find_first_of(const wxString& str, size_t nStart = 0) const;
// same as rfind(char, size_t)
size_t find_last_of (char c, size_t nStart = npos) const;
- // find first/last occurence of any character not in the set
+ // find first/last occurrence of any character not in the set
//
size_t find_first_not_of(const wxString& str, size_t nStart = 0) const;
\constfunc{wxString}{AfterFirst}{\param{char}{ ch}}
-Gets all the characters after the first occurence of {\it ch}.
+Gets all the characters after the first occurrence of {\it ch}.
Returns the empty string if {\it ch} is not found.
\membersection{wxString::AfterLast}\label{wxstringafterlast}
\constfunc{wxString}{AfterLast}{\param{char}{ ch}}
-Gets all the characters after the last occurence of {\it ch}.
+Gets all the characters after the last occurrence of {\it ch}.
Returns the whole string if {\it ch} is not found.
\membersection{wxString::BeforeFirst}\label{wxstringbeforefirst}
\constfunc{wxString}{BeforeFirst}{\param{char}{ ch}}
-Gets all characters before the first occurence of {\it ch}.
+Gets all characters before the first occurrence of {\it ch}.
Returns the whole string if {\it ch} is not found.
\membersection{wxString::BeforeLast}\label{wxstringbeforelast}
\constfunc{wxString}{BeforeLast}{\param{char}{ ch}}
-Gets all characters before the last occurence of {\it ch}.
+Gets all characters before the last occurrence of {\it ch}.
Returns the empty string if {\it ch} is not found.
\membersection{wxString::c\_str}\label{wxstringcstr}
\constfunc{bool}{IsAscii}{\void}
-Returns TRUE if the string is ASCII.
+Returns TRUE if the string contains only ASCII characters.
\membersection{wxString::IsEmpty}\label{wxstringisempty}
\constfunc{bool}{IsEmpty}{\void}
-Returns TRUE if the string is NULL.
+Returns TRUE if the string is empty.
\membersection{wxString::IsNull}\label{wxstringisnull}
\constfunc{bool}{IsNull}{\void}
-Returns TRUE if the string is NULL (same as IsEmpty).
+Returns TRUE if the string is empty (same as \helpref{IsEmpty}{wxstringisempty}).
\membersection{wxString::IsNumber}\label{wxstringisnumber}
\constfunc{bool}{IsNumber}{\void}
-Returns TRUE if the string is a positive or negative integer. Will return FALSE for decimals.
+Returns TRUE if the string is an integer (with possible sign).
\membersection{wxString::IsSameAs}\label{wxstringissameas}
\constfunc{wxString}{Left}{\param{char}{ ch}}
-Returns all characters before the first occurence of {\it ch}.
+Returns all characters before the first occurrence of {\it ch}.
Returns the whole string if {\it ch} is not found.
\membersection{wxString::Len}\label{wxstringlen}
\func{size\_t}{Replace}{\param{const char*}{ szOld}, \param{const char*}{ szNew}, \param{bool}{ replaceAll = TRUE}}
-Replace first (or all) occurences of substring with another one.
+Replace first (or all) occurrences of substring with another one.
-{\it replaceAll}: global replace (default), or only the first occurence.
+{\it replaceAll}: global replace (default), or only the first occurrence.
Returns the number of replacements made.
\constfunc{wxString}{SubString}{\param{size\_t}{ from}, \param{size\_t}{ to}}
-Same as \helpref{Mid}{wxstringmid}.
+Deprecated, use \helpref{Mid}{wxstringmid} instead (but note that parameters
+have different meaning).
+
+Returns the part of the string between the indices {\it from} and {\it to}
+inclusive.
\membersection{wxString::ToDouble}\label{wxstringtodouble}
\membersection{wxString::ToLong}\label{wxstringtolong}
-\constfunc{bool}{ToLong}{\param{long}{ *val}}
+\constfunc{bool}{ToLong}{\param{long}{ *val}, \param{int }{base = 0}}
+
+Attempts to convert the string to a signed integer in base {\it base}. Returns
+{\tt TRUE} on success in which case the number is stored in the location
+pointed to by {\it val} or {\tt FALSE} if the string does not represent a
+valid number in the given base.
-Attempts to convert the string to a signed integer. Returns TRUE on success
-(the number is stored in the location pointed to by {\it val}) or FALSE if the
-string does not represent such number.
+The default value of {\it base} $0$ is special and means that the usual rules
+of {\tt C} numbers are applied: if the number starts with {\tt 0x} it is
+considered to be in base $16$, if it starts with {\tt 0} - in base $8$ and in
+base $10$ otherwise.
\wxheading{See also}
\membersection{wxString::ToULong}\label{wxstringtoulong}
-\constfunc{bool}{ToULong}{\param{unsigned long}{ *val}}
+\constfunc{bool}{ToULong}{\param{unsigned long}{ *val}, \param{int }{base = 0}}
+
+Attempts to convert the string to a ansigned integer in base {\it base}.
+Returns {\tt TRUE} on success in which case the number is stored in the
+location pointed to by {\it val} or {\tt FALSE} if the string does not
+represent a valid number in the given base.
-Attempts to convert the string to an unsigned integer. Returns TRUE on success
-(the number is stored in the location pointed to by {\it val}) or FALSE if the
-string does not represent such number.
+The default value of {\it base} $0$ is special and means that the usual rules
+of {\tt C} numbers are applied: if the number starts with {\tt 0x} it is
+considered to be in base $16$, if it starts with {\tt 0} - in base $8$ and in
+base $10$ otherwise.
\wxheading{See also}
projects / wxWidgets.git / blobdiff