Boost logo

Boost-Commit :

From: chochlik_at_[hidden]
Date: 2008-04-22 03:43:17


Author: matus.chochlik
Date: 2008-04-22 03:43:16 EDT (Tue, 22 Apr 2008)
New Revision: 44714
URL: http://svn.boost.org/trac/boost/changeset/44714

Log:
Made minor changes to documentation
Text files modified:
   sandbox/mirror/libs/doc/xml/mirror/sections/char_type.xml | 2 +-
   1 files changed, 1 insertions(+), 1 deletions(-)

Modified: sandbox/mirror/libs/doc/xml/mirror/sections/char_type.xml
==============================================================================
--- sandbox/mirror/libs/doc/xml/mirror/sections/char_type.xml (original)
+++ sandbox/mirror/libs/doc/xml/mirror/sections/char_type.xml 2008-04-22 03:43:16 EDT (Tue, 22 Apr 2008)
@@ -12,7 +12,7 @@
         </note>
         <paragraph>
                 This approach allows to switch the character type without the need to do any changes to the code. A feature that is handy in some situations. Since the definition of <cpp_expr>bchar</cpp_expr> is always the same as the definition of <cpp_expr>TCHAR</cpp_expr> on Windows, this also allows smooth cooperation between <lib_name_ref/> and WinAPI with both <cpp_expr>char</cpp_expr>s and <cpp_expr>wchar_t</cpp_expr>s.
- Any WinAPI function that takes <cpp_expr>TCHAR</cpp_expr> or a pointer to <cpp_expr>TCHAR</cpp_expr> can be safely used with <cpp_expr>bchar</cpp_expr>. Thus it is better, safer and more robust to call <cpp_expr>LoadLibrary</cpp_expr> with a <cpp_expr>bchar*</cpp_expr> argument than to directly call <cpp_expr>LoadLibraryA</cpp_expr> with <cpp_expr>char*</cpp_expr> argument or <cpp_expr>LoadLibraryW</cpp_expr> with <cpp_expr>wchar_t*</cpp_expr> argument.
+ Any WinAPI function that takes <cpp_expr>TCHAR</cpp_expr> or a pointer to <cpp_expr>TCHAR</cpp_expr> can be safely used with <cpp_expr>bchar</cpp_expr>. Thus it is better to call <cpp_expr>LoadLibrary</cpp_expr> with a <cpp_expr>bchar*</cpp_expr> argument than to directly call <cpp_expr>LoadLibraryA</cpp_expr> with <cpp_expr>char*</cpp_expr> argument or <cpp_expr>LoadLibraryW</cpp_expr> with <cpp_expr>wchar_t*</cpp_expr> argument.
         </paragraph>
         <note>
                 The current implementation is far from perfect. It is more than probable that the functions from <filepath>cstring</filepath> like <cpp_expr>strlen</cpp_expr>/<cpp_expr>wcslen</cpp_expr>, <cpp_expr>strcpy</cpp_expr>/<cpp_expr>wcscpy</cpp_expr> will have to be wrapped by functions like <cpp_expr>bstrlen</cpp_expr>, <cpp_expr>bstrcpy</cpp_expr>, etc taking <cpp_expr>bchar</cpp_expr> as argument instead of <cpp_expr>char</cpp_expr>/<cpp_expr>wchar_t</cpp_expr>.


Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk