Minor formating

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54922 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Robert Roebling
2008-08-02 14:10:54 +00:00
parent 707d9f4047
commit 0c339e7c64
2 changed files with 31 additions and 18 deletions

View File

@@ -123,6 +123,8 @@ public:
append something to a C string (including literal constants), so to do this it append something to a C string (including literal constants), so to do this it
should be converted to a wxString first. should be converted to a wxString first.
@li insert()
@li append()
@li operator<<() @li operator<<()
@li operator+=() @li operator+=()
@li operator+() @li operator+()
@@ -137,6 +139,7 @@ public:
@li wxString() @li wxString()
@li operator=() @li operator=()
@li ~wxString() @li ~wxString()
@li assign()
The MakeXXX() variants modify the string in place, while the other functions The MakeXXX() variants modify the string in place, while the other functions
return a new string which contains the original text converted to the upper or return a new string which contains the original text converted to the upper or
@@ -146,6 +149,8 @@ public:
@li Upper() @li Upper()
@li MakeLower() @li MakeLower()
@li Lower() @li Lower()
@li MakeCapitalized()
@li Capitalize()
Many functions below take a character index in the string. As with C Many functions below take a character index in the string. As with C
strings and arrays, the indices start from 0, so the first character of a strings and arrays, the indices start from 0, so the first character of a
@@ -169,10 +174,9 @@ public:
@li mb_str() @li mb_str()
@li fn_str() @li fn_str()
The default comparison function Cmp() is case-sensitive and The default comparison function Cmp() is case-sensitive and so is the default
so is the default version of IsSameAs(). For case version of IsSameAs(). For case insensitive comparisons you should use CmpNoCase()
insensitive comparisons you should use CmpNoCase() or or give a second parameter to IsSameAs(). This last function is maybe more
give a second parameter to IsSameAs. This last function is may be more
convenient if only equality of the strings matters because it returns a boolean convenient if only equality of the strings matters because it returns a boolean
@true value if the strings are the same and not 0 (which is usually @false @true value if the strings are the same and not 0 (which is usually @false
in C) as Cmp() does. in C) as Cmp() does.
@@ -182,6 +186,7 @@ public:
with some predefined prefix and is more efficient than doing direct string with some predefined prefix and is more efficient than doing direct string
comparison as you would also have to precalculate the length of the prefix. comparison as you would also have to precalculate the length of the prefix.
@li compare()
@li Cmp() @li Cmp()
@li CmpNoCase() @li CmpNoCase()
@li IsSameAs() @li IsSameAs()
@@ -206,6 +211,8 @@ public:
when working with some external API which requires the caller to provide when working with some external API which requires the caller to provide
a writable buffer. a writable buffer.
@li reserve()
@li resize()
@li Alloc() @li Alloc()
@li Shrink() @li Shrink()
@li wxStringBuffer @li wxStringBuffer
@@ -220,6 +227,8 @@ public:
These functions return the string length and check whether the string These functions return the string length and check whether the string
is empty or they empty it. is empty or they empty it.
@li length()
@li size()
@li Len() @li Len()
@li IsEmpty() @li IsEmpty()
@li operator!() @li operator!()
@@ -230,6 +239,7 @@ public:
original string is not modified and the function returns the extracted original string is not modified and the function returns the extracted
substring. substring.
@li substr()
@li Mid() @li Mid()
@li operator()() @li operator()()
@li Left() @li Left()
@@ -244,6 +254,9 @@ public:
These functions replace the standard @e strchr() and @e strstr() These functions replace the standard @e strchr() and @e strstr()
functions. functions.
@li find()
@li rfind()
@li replace()
@li Find() @li Find()
@li Replace() @li Replace()

View File

@@ -22,8 +22,8 @@
class that has O(1) access to its content, to be identical on all class that has O(1) access to its content, to be identical on all
platforms and to be easily convertable to wxString as well as other platforms and to be easily convertable to wxString as well as other
ways to store strings (C string literals, wide character ways to store strings (C string literals, wide character
string literals, character buffer, etc) by providing many overload string literals, character buffer, etc) by providing several overloads
and built-in conversion to and from the various format. and built-in conversions to and from the various string formats.
wxUString derives from @c std::basic_string<wxChar32> and therefore wxUString derives from @c std::basic_string<wxChar32> and therefore
offers the complete API of @c std::string. offers the complete API of @c std::string.
@@ -204,35 +204,35 @@ public:
operator wxString() const; operator wxString() const;
/** /**
wxUString assignment. wxUString addtionally provides overloads for wxUString assignment. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single and repeated characters etc. single and repeated characters etc.
*/ */
wxUString &assign( const wxUString &str ); wxUString &assign( const wxUString &str );
/** /**
Appending. wxUString addtionally provides overloads for Appending. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single and repeated characters etc. single and repeated characters etc.
*/ */
wxUString &append( const wxUString &s ); wxUString &append( const wxUString &s );
/** /**
Insertion. wxUString addtionally provides overloads for Insertion. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
wxUString &insert( size_type pos, const wxUString &s ); wxUString &insert( size_type pos, const wxUString &s );
/** /**
Assignment operator. wxUString addtionally provides overloads for Assignment operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline wxUString& operator=(const wxUString& s); inline wxUString& operator=(const wxUString& s);
/** /**
Concatenation operator. wxUString addtionally provides overloads for Concatenation operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
@@ -241,44 +241,44 @@ public:
}; };
/** /**
Concatenation operator. wxUString addtionally provides overloads for Concatenation operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline wxUString operator+(const wxUString &s1, const wxUString &s2); inline wxUString operator+(const wxUString &s1, const wxUString &s2);
/** /**
Equality operator. wxUString addtionally provides overloads for Equality operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline bool operator==(const wxUString& s1, const wxUString& s2); inline bool operator==(const wxUString& s1, const wxUString& s2);
/** /**
Inequality operator. wxUString addtionally provides overloads for Inequality operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline bool operator!=(const wxUString& s1, const wxUString& s2); inline bool operator!=(const wxUString& s1, const wxUString& s2);
/** /**
Comparison operator. wxUString addtionally provides overloads for Comparison operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline bool operator< (const wxUString& s1, const wxUString& s2); inline bool operator< (const wxUString& s1, const wxUString& s2);
/** /**
Comparison operator. wxUString addtionally provides overloads for Comparison operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline bool operator> (const wxUString& s1, const wxUString& s2); inline bool operator> (const wxUString& s1, const wxUString& s2);
/** /**
Comparison operator. wxUString addtionally provides overloads for Comparison operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */
inline bool operator<=(const wxUString& s1, const wxUString& s2); inline bool operator<=(const wxUString& s1, const wxUString& s2);
/** /**
Comparison operator. wxUString addtionally provides overloads for Comparison operator. wxUString additionally provides overloads for
wxString, C string, UTF-16 strings, 32-bit strings, char buffers, wxString, C string, UTF-16 strings, 32-bit strings, char buffers,
single characters etc. single characters etc.
*/ */