X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/474e9711477a5737b232435525da1c87f7eb72d2..36a0190ebd5bd9a7302f60f6dcd608b80574e21c:/interface/wx/unichar.h?ds=inline diff --git a/interface/wx/unichar.h b/interface/wx/unichar.h index 4866c1c11d..75012879f2 100644 --- a/interface/wx/unichar.h +++ b/interface/wx/unichar.h @@ -2,8 +2,7 @@ // Name: unichar.h // Purpose: interface of wxUniChar // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @@ -33,7 +32,7 @@ public: //@{ /** Create a character from the 8-bit character value @a c using the - current locale’s encoding. + current locale encoding. */ wxUniChar(char c); wxUniChar(unsigned char c); @@ -45,6 +44,8 @@ public: wxUniChar(unsigned long int c); wxUniChar(short int c); wxUniChar(unsigned short int c); + wxUniChar(wxLongLong_t c); + wxUniChar(wxULongLong_t c); wxUniChar(const wxUniCharRef& c); @@ -54,10 +55,34 @@ public: value_type GetValue() const; /** - Returns true if the character is an ASCII character (i.e. if its value is less than 128). + Returns true if the character is an ASCII character (i.e.\ if its value is less than 128). */ bool IsAscii() const; + /** + Returns true if the character is representable as a single byte in the + current locale encoding. + + This function only returns true if the character can be converted in + exactly one byte, e.g. it only returns true for 7 bit ASCII characters + when the encoding used is UTF-8. + + It is mostly useful to test if the character can be passed to functions + taking a char and is used by wxWidgets itself for this purpose. + + @param c + An output pointer to the value of this Unicode character as a @c + char. Must be non-@NULL. + @return + @true if the object is an 8 bit char and @a c was filled with its + value as char or @false otherwise (@a c won't be modified then). + + @see IsAscii() + + @since 2.9.1 + */ + bool GetAsChar(char *c) const; + //@{ /** Conversions to char and wchar_t types: all of those are needed to be @@ -73,6 +98,8 @@ public: operator unsigned long int() const; operator short int() const; operator unsigned short int() const; + operator wxLongLong_t() const; + operator wxULongLong_t() const; //@} //@{ @@ -90,6 +117,8 @@ public: wxUniChar& operator=(unsigned long int c); wxUniChar& operator=(short int c); wxUniChar& operator=(unsigned short int c); + wxUniChar& operator=(wxLongLong_t c); + wxUniChar& operator=(wxULongLong_t c); //@} };