X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ca164e2337d4f014cb42ac0354cea467cdf2f194..b5fe7ca67bf3121959a0b5a59afd00c1708f2f03:/interface/wx/string.h

diff --git a/interface/wx/string.h b/interface/wx/string.h
index 1cda9cfd76..b937a5267b 100644
--- a/interface/wx/string.h
+++ b/interface/wx/string.h
@@ -246,7 +246,8 @@
     @stdobjects
     ::wxEmptyString
 
-    @see @ref overview_string, @ref overview_unicode, wxUString
+    @see @ref overview_string, @ref overview_unicode, wxUString,
+         wxCharBuffer, wxUniChar, wxStringTokenizer, @ref group_funcmacro_string
 */
 class wxString
 {
@@ -1348,10 +1349,11 @@ public:
     //@}
 };
 
-/** @addtogroup group_string_operators */
+
+
 //@{
 /**
-    Comparison operators for wxString.
+    Comparison operator for string types.
 */
 inline bool operator==(const wxString& s1, const wxString& s2);
 inline bool operator!=(const wxString& s1, const wxString& s2);
@@ -1371,9 +1373,11 @@ inline bool operator==(const wxString& s1, const wxCharBuffer& s2);
 inline bool operator==(const wxCharBuffer& s1, const wxString& s2);
 inline bool operator!=(const wxString& s1, const wxCharBuffer& s2);
 inline bool operator!=(const wxCharBuffer& s1, const wxString& s2);
+//@}
 
+//@{
 /**
-    Comparison operators with wxUniChar or wxUniCharRef.
+    Comparison operators char types.
 */
 inline bool operator==(const wxUniChar& c, const wxString& s);
 inline bool operator==(const wxUniCharRef& c, const wxString& s);
@@ -1403,7 +1407,6 @@ wxString wxEmptyString;
 
 
 
-
 /**
     @class wxStringBufferLength
 
@@ -1526,3 +1529,29 @@ public:
     */
     wxStringCharType* operator wxStringCharType *();
 };
+
+
+/** @addtogroup group_funcmacro_string */
+//@{
+
+/**
+    Allows to extend a function with the signature:
+    @code bool SomeFunc(const wxUniChar& c) @endcode
+    which operates on a single character, to an entire wxString.
+
+    E.g. if you want to check if an entire string contains only digits,
+    you can do:
+    @code
+        if (wxStringCheck<wxIsdigit>(myString))
+            ... // the entire string contains oly digits!
+        else
+            ... // at least one character of myString is not a digit
+    @endcode
+
+    @return @true if the given function returns a non-zero value for all
+            characters of the @a val string.
+*/
+template<bool (T)(const wxUniChar& c)>
+    inline bool wxStringCheck(const wxString& val);
+
+//@}