locale/doc/faq.txt
Artyom Beilis 802f5d031d - Merge: svn merge -r 1882:1885 https://cppcms.svn.sourceforge.net/svnroot/cppcms/boost_locale/trunk
- Fixed issues with inspector
  - Changed the use of boost::mutex - not include entire boost.thread
- Updated documentation build script


[SVN r73059]
2011-07-13 18:05:40 +00:00

51 lines
1.9 KiB
Plaintext

//
// Copyright (c) 2009-2011 Artyom Beilis (Tonkikh)
//
// Distributed under the Boost Software License, Version 1.0. (See
// accompanying file LICENSE_1_0.txt or copy at
// http://www.boost.org/LICENSE_1_0.txt)
//
// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 filetype=cpp.doxygen
/*!
\page faq Frequently Asked Questions
- \anchor faq_bad_cast <b>I try to use some Boost.Locale functions and I get an \c std::bad_cast exception thrown?</b>
\n
\n
\b Answer: You probably try to use incorrect \c std::locale object. All Boost.Locale tools relay on \c std::locale object's facets.
The locale object should be generated with \ref boost::locale::generator "generator" class and then passed to
the function or alternatively global locale should be set using \c std::locale::global() function such that
global locale (and default created one) would have required facets to use.
- \anchor faq_number <b>I had installed global locale and try to write something to stream but still get wrong output?</b>
For example:
\code
#include <boost/locale.hpp>
#include <iostream>
int main()
{
boost::locale::generator gen;
std::locale::global(gen(""));
std::cout << boost::locale::as::date << std::time(0) << std::endl;
}
\endcode
Prints a number instead of a date.
\n
\b Answer: You forget to imbue the locale to the stream. Changing the global locale does not affect the
locale in existing \c iostream objects. Thus because \c std::out and other global streams were created
before changing the global locale Boost.Locale manipulators have no effect. You need to write:
\code
#include <boost/locale.hpp>
#include <iostream>
int main()
{
boost::locale::generator gen;
std::locale l = gen("");
std::locale::global(l);
std::cout.imbue(l);
std::cout << boost::locale::as::date << std::time(0) << std::endl;
}
\endcode
*/