You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and dots ('.'), can be up to 35 characters long. Letters must be lowercase.
246 lines
9.5 KiB
246 lines
9.5 KiB
// |
|
// 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) |
|
// |
|
#ifndef BOOST_LOCALE_ENCODING_HPP_INCLUDED |
|
#define BOOST_LOCALE_ENCODING_HPP_INCLUDED |
|
|
|
#include <boost/locale/config.hpp> |
|
#ifdef BOOST_MSVC |
|
# pragma warning(push) |
|
# pragma warning(disable : 4275 4251 4231 4660) |
|
#endif |
|
#include <boost/locale/info.hpp> |
|
#include <boost/locale/encoding_errors.hpp> |
|
#include <boost/locale/encoding_utf.hpp> |
|
|
|
|
|
|
|
namespace boost { |
|
namespace locale { |
|
|
|
/// |
|
/// \brief Namespace that contains all functions related to character set conversion |
|
/// |
|
namespace conv { |
|
/// |
|
/// \defgroup codepage Character conversion functions |
|
/// |
|
/// @{ |
|
|
|
/// |
|
/// convert string to UTF string from text in range [begin,end) encoded with \a charset according to policy \a how |
|
/// |
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(char const *begin,char const *end,std::string const &charset,method_type how=default_method); |
|
|
|
/// |
|
/// convert UTF text in range [begin,end) to a text encoded with \a charset according to policy \a how |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(CharType const *begin,CharType const *end,std::string const &charset,method_type how=default_method); |
|
|
|
/// |
|
/// convert string to UTF string from text in range [begin,end) encoded according to locale \a loc according to policy \a how |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(char const *begin,char const *end,std::locale const &loc,method_type how=default_method) |
|
{ |
|
return to_utf<CharType>(begin,end,std::use_facet<info>(loc).encoding(),how); |
|
} |
|
|
|
/// |
|
/// convert UTF text in range [begin,end) to a text encoded according to locale \a loc according to policy \a how |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(CharType const *begin,CharType const *end,std::locale const &loc,method_type how=default_method) |
|
{ |
|
return from_utf(begin,end,std::use_facet<info>(loc).encoding(),how); |
|
} |
|
|
|
/// |
|
/// convert a string \a text encoded with \a charset to UTF string |
|
/// |
|
|
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(std::string const &text,std::string const &charset,method_type how=default_method) |
|
{ |
|
return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),charset,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text from \a charset to UTF string |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(std::basic_string<CharType> const &text,std::string const &charset,method_type how=default_method) |
|
{ |
|
return from_utf(text.c_str(),text.c_str()+text.size(),charset,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text from \a charset to UTF string |
|
/// |
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(char const *text,std::string const &charset,method_type how=default_method) |
|
{ |
|
char const *text_end = text; |
|
while(*text_end) |
|
text_end++; |
|
return to_utf<CharType>(text,text_end,charset,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text from UTF to \a charset |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(CharType const *text,std::string const &charset,method_type how=default_method) |
|
{ |
|
CharType const *text_end = text; |
|
while(*text_end) |
|
text_end++; |
|
return from_utf(text,text_end,charset,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text in locale encoding given by \a loc to UTF |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(std::string const &text,std::locale const &loc,method_type how=default_method) |
|
{ |
|
return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),loc,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text in UTF to locale encoding given by \a loc |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(std::basic_string<CharType> const &text,std::locale const &loc,method_type how=default_method) |
|
{ |
|
return from_utf(text.c_str(),text.c_str()+text.size(),loc,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text in locale encoding given by \a loc to UTF |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::basic_string<CharType> to_utf(char const *text,std::locale const &loc,method_type how=default_method) |
|
{ |
|
char const *text_end = text; |
|
while(*text_end) |
|
text_end++; |
|
return to_utf<CharType>(text,text_end,loc,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text in UTF to locale encoding given by \a loc |
|
/// |
|
/// \note throws std::bad_cast if the loc does not have \ref info facet installed |
|
/// |
|
template<typename CharType> |
|
std::string from_utf(CharType const *text,std::locale const &loc,method_type how=default_method) |
|
{ |
|
CharType const *text_end = text; |
|
while(*text_end) |
|
text_end++; |
|
return from_utf(text,text_end,loc,how); |
|
} |
|
|
|
|
|
/// |
|
/// Convert a text in range [begin,end) to \a to_encoding from \a from_encoding |
|
/// |
|
|
|
BOOST_LOCALE_DECL |
|
std::string between(char const *begin, |
|
char const *end, |
|
std::string const &to_encoding, |
|
std::string const &from_encoding, |
|
method_type how=default_method); |
|
|
|
/// |
|
/// Convert a \a text to \a to_encoding from \a from_encoding |
|
/// |
|
|
|
inline |
|
std::string between(char const *text, |
|
std::string const &to_encoding, |
|
std::string const &from_encoding, |
|
method_type how=default_method) |
|
{ |
|
char const *end=text; |
|
while(*end) |
|
end++; |
|
return boost::locale::conv::between(text,end,to_encoding,from_encoding,how); |
|
} |
|
|
|
/// |
|
/// Convert a \a text to \a to_encoding from \a from_encoding |
|
/// |
|
inline |
|
std::string between(std::string const &text, |
|
std::string const &to_encoding, |
|
std::string const &from_encoding, |
|
method_type how=default_method) |
|
{ |
|
return boost::locale::conv::between(text.c_str(),text.c_str()+text.size(),to_encoding,from_encoding,how); |
|
} |
|
|
|
/// \cond INTERNAL |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::basic_string<char> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::string from_utf(char const *begin,char const *end,std::string const &charset,method_type how); |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::basic_string<wchar_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::string from_utf(wchar_t const *begin,wchar_t const *end,std::string const &charset,method_type how); |
|
|
|
#ifdef BOOST_HAS_CHAR16_T |
|
template<> |
|
BOOST_LOCALE_DECL std::basic_string<char16_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::string from_utf(char16_t const *begin,char16_t const *end,std::string const &charset,method_type how); |
|
#endif |
|
|
|
#ifdef BOOST_HAS_CHAR32_T |
|
template<> |
|
BOOST_LOCALE_DECL std::basic_string<char32_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); |
|
|
|
template<> |
|
BOOST_LOCALE_DECL std::string from_utf(char32_t const *begin,char32_t const *end,std::string const &charset,method_type how); |
|
#endif |
|
|
|
|
|
/// @} |
|
|
|
} // conv |
|
|
|
} // locale |
|
} // boost |
|
|
|
#ifdef BOOST_MSVC |
|
#pragma warning(pop) |
|
#endif |
|
|
|
#endif |
|
|
|
// vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 |
|
|
|
|