// Name: unichar.h
// Purpose: interface of wxUniChar
// Author: wxWidgets team
-// RCS-ID: $Id$
-// Licence: wxWindows license
+// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
/**
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);
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
operator unsigned long int() const;
operator short int() const;
operator unsigned short int() const;
+ operator wxLongLong_t() const;
+ operator wxULongLong_t() const;
//@}
//@{
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);
//@}
};