status_of_cpp0x_characters_support.txt 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. //
  2. // Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
  3. //
  4. // Distributed under the Boost Software License, Version 1.0. (See
  5. // accompanying file LICENSE_1_0.txt or copy at
  6. // http://www.boost.org/LICENSE_1_0.txt)
  7. //
  8. // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen
  9. /*!
  10. \page status_of_cpp0x_characters_support Status of C++11 char16_t/char32_t support
  11. The support of C++11 \c char16_t and \c char32_t is experimental, mostly does not work and not
  12. intended to be used in production with current latest compilers: GCC-4.5, MSVC10 till major
  13. compiler's flaws would be fixed.
  14. \section status_of_cpp0x_characters_support_gnu GNU GCC 4.5/C++11 Status
  15. GNU C++ compiler provides decent support of C++11 characters however:
  16. -# Standard library does not install any std::locale::facets for this support so any attempt
  17. to format numbers using \c char16_t or \c char32_t streams would just fail.
  18. -# Standard library misses specialization for required \c char16_t/char32_t locale facets,
  19. so "std" backends is not build-able as essential symbols missing, also \c codecvt facet
  20. can't be created as well.
  21. \section status_of_cpp0x_characters_support_msvc Visual Studio 2010 (MSVC10)/C++11 Status
  22. MSVC provides all required facets however:
  23. -# Standard library does not provide installations of std::locale::id for these facets
  24. in DLL so it is not usable with \c /MD, \c /MDd compiler flags and requires static link of the runtime
  25. library.
  26. -# \c char16_t and \c char32_t are not distinct types but rather aliases of unsigned short and unsigned
  27. types which contradicts to C++11 requirements making it impossible to write \c char16_t/char32_t to stream
  28. and causing multiple faults.
  29. If you want to build or test Boost.Locale with C++11 char16_t and char32_t support you should pass `cxxflags="-DBOOST_LOCALE_ENABLE_CHAR32_T -DBOOST_LOCALE_ENABLE_CHAR16_T"` to `b2` during build and define `BOOST_LOCALE_ENABLE_CHAR32_T` and `BOOST_LOCALE_ENABLE_CHAR32_T` when using Boost.Locale
  30. */