Avoid needless second string conversion when adding files to memory FS.

[wxWidgets.git] / interface / wx / encconv.h

diff --git a/interface/wx/encconv.h b/interface/wx/encconv.h
index ceba036f84db006c22cec23557f7d2866af5428d..7bf0a48c535b7a5e3c87075675f8341f9539f1c3 100644 (file)
--- a/interface/wx/encconv.h
+++ b/interface/wx/encconv.h
@@ -3,15 +3,14 @@
 // Purpose:     interface of wxEncodingConverter
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Purpose:     interface of wxEncodingConverter
 // Author:      wxWidgets team
 // RCS-ID:      $Id$

-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxEncodingConverter
 
     This class is capable of converting strings between two 8-bit encodings/charsets.
 /////////////////////////////////////////////////////////////////////////////
 
 /**
     @class wxEncodingConverter
 
     This class is capable of converting strings between two 8-bit encodings/charsets.

-    It can also convert from/to Unicode (but only if you compiled wxWidgets
-    with @c wxUSE_WCHAR_T set to 1).
+    It can also convert from/to Unicode.

 
     Only a limited subset of encodings is supported by wxEncodingConverter:
     @c wxFONTENCODING_ISO8859_1..15, @c wxFONTENCODING_CP1250..1257 and
 
     Only a limited subset of encodings is supported by wxEncodingConverter:
     @c wxFONTENCODING_ISO8859_1..15, @c wxFONTENCODING_CP1250..1257 and


@@ -64,9 +63,6 @@ public:
         considered a lossless operation.
 
         @note You must call Init() before using this method!
         considered a lossless operation.
 
         @note You must call Init() before using this method!

-
-        @note wchar_t versions of the method are not available if wxWidgets was
-              compiled with @c wxUSE_WCHAR_T set to 0.

     */
     bool Convert(const char* input, char* output) const;
     bool Convert(const wchar_t* input, wchar_t* output) const;
     */
     bool Convert(const char* input, char* output) const;
     bool Convert(const wchar_t* input, wchar_t* output) const;


@@ -74,12 +70,23 @@ public:
     bool Convert(const wchar_t* input, char* output) const;
 
     /**
     bool Convert(const wchar_t* input, char* output) const;
 
     /**

-        Convert input string according to settings passed to Init() in-place,
-        i.e. write the result to the same memory area.
+        Convert input string according to settings passed to Init() in-place.
+
+        With this overload, the conversion result is written to the same memory
+        area from which the input is read.

 
         See the Convert(const char*,char*) const overload for more info.
     */
     bool Convert(char* str) const;
 
         See the Convert(const char*,char*) const overload for more info.
     */
     bool Convert(char* str) const;

+
+    /**
+        Convert input string according to settings passed to Init() in-place.
+
+        With this overload, the conversion result is written to the same memory
+        area from which the input is read.
+
+        See the Convert(const wchar_t*,wchar_t*) const overload for more info.
+    */

     bool Convert(wchar_t* str) const;
 
     /**
     bool Convert(wchar_t* str) const;
 
     /**