Text Conversion

Detailed Description

These are the classes used for conversions between different text encodings.

Classes
class	wxEncodingConverter
	This class is capable of converting strings between two 8-bit encodings/charsets. More...
class	wxMBConv
	This class is the base class of a hierarchy of classes capable of converting text strings between multibyte (SBCS or DBCS) encodings and Unicode. More...
class	wxMBConvUTF7
	This class converts between the UTF-7 encoding and Unicode. More...
class	wxMBConvUTF8
	This class converts between the UTF-8 encoding and Unicode. More...
class	wxMBConvUTF16
	This class is used to convert between multibyte encodings and UTF-16 Unicode encoding (also known as UCS-2). More...
class	wxMBConvUTF32
	This class is used to convert between multibyte encodings and UTF-32 Unicode encoding (also known as UCS-4). More...
class	wxCSConv
	This class converts between any character set supported by the system and Unicode. More...

Variables
wxMBConv *	wxConvFileName
	Conversion object used for converting file names from their external representation to the one used inside the program.

Variable Documentation

wxMBConv* wxConvFileName

Conversion object used for converting file names from their external representation to the one used inside the program.

wxConvFileName converts filenames between filesystem multibyte encoding and Unicode. wxConvFileName can also be set to a something else at run-time which is used e.g. by wxGTK to use an object which checks the environment variable G_FILESYSTEM_ENCODING indicating that filenames should not be interpreted as UTF8 and also for converting invalid UTF8 characters (e.g. if there is a filename in iso8859_1) to strings with octal values.

Since some platforms (such as Win32) use Unicode in the filenames, and others (such as Unix) use multibyte encodings, this object should only be used directly if wxMBFILES is defined to 1. A convenience macro, wxFNCONV, is defined to wxConvFileName->cWX2MB in this case. You could use it like this:

wxChar *name = "rawfile.doc";
FILE *fil = fopen(wxFNCONV(name), "r");

(although it would be better to just use wxFopen(name, "r") in this particular case, you only need to use this object for functions taking file names not wrapped by wxWidgets.)

Library:  wxBase

Category:  Text Conversion

See Also

wxMBConv Overview