From 1c2ed09a15a5eccaa1f78d3c57a597c13ba9f8f1 Mon Sep 17 00:00:00 2001 From: Michael Wetherell Date: Wed, 10 Aug 2005 21:50:34 +0000 Subject: [PATCH] Mention converting ANSI->Unicode, patch 1247339 Eric Kow git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@35171 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- docs/latex/wx/tunicode.tex | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/latex/wx/tunicode.tex b/docs/latex/wx/tunicode.tex index 880a3f8da9..01973d69d1 100644 --- a/docs/latex/wx/tunicode.tex +++ b/docs/latex/wx/tunicode.tex @@ -162,7 +162,7 @@ ANSI strings (a notable exception is the entire Win32 API which accepts either Unicode or ANSI strings and which thus makes it unnecessary to ever perform any conversions in the program). GTK 2.0 only accepts UTF-8 strings. -To get a ANSI string from a wxString, you may use the +To get an ANSI string from a wxString, you may use the mb\_str() function which always returns an ANSI string (independently of the mode - while the usual \helpref{c\_str()}{wxstringcstr} returns a pointer to the internal @@ -170,6 +170,20 @@ representation which is either ASCII or Unicode). More rarely used, but still useful, is wc\_str() function which always returns the Unicode string. +Sometimes it is also necessary to go from ANSI strings to wxStrings. +In this case, you can use the converter-constructor, as follows: + +\begin{verbatim} + const char* ascii_str = "Some text"; + wxString str(ascii_str, wxConvUTF8); +\end{verbatim} + +This code also compiles fine under a non-Unicode build of wxWidgets, +but in that case the converter is ignored. + +For more information about converters and Unicode see +the \helpref{wxMBConv classes overview}{mbconvclasses}. + % TODO describe fn_str(), wx_str(), wxCharBuf classes, ... \subsection{Unicode-related compilation settings}\label{unicodesettings}