Character conversion functions

Classes
class	boost::locale::conv::conversion_error
	The excepton that is thrown in case of conversion error. More...
class	boost::locale::conv::invalid_charset_error
	This exception is thrown in case of use of unsupported or invalid character set. More...

Enumerations
enum	boost::locale::conv::method_type {   boost::locale::conv::skip = 0,   boost::locale::conv::stop = 1,   boost::locale::conv::default_method = skip }
	enum that defines conversion policy More...

Functions
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (char const *begin, char const *end, std::string const &charset, method_type how=default_method)
	convert string to UTF string from text in range [begin,end) encoded with charset according to policy how More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (CharType const *begin, CharType const *end, std::string const &charset, method_type how=default_method)
	convert UTF text in range [begin,end) to a text encoded with charset according to policy how More...
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (char const *begin, char const *end, std::locale const &loc, method_type how=default_method)
	convert string to UTF string from text in range [begin,end) encoded according to locale loc according to policy how More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (CharType const *begin, CharType const *end, std::locale const &loc, method_type how=default_method)
	convert UTF text in range [begin,end) to a text encoded according to locale loc according to policy how More...
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (std::string const &text, std::string const &charset, method_type how=default_method)
	convert a string text encoded with charset to UTF string More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (std::basic_string< CharType > const &text, std::string const &charset, method_type how=default_method)
	Convert a text from charset to UTF string. More...
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (char const *text, std::string const &charset, method_type how=default_method)
	Convert a text from charset to UTF string. More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (CharType const *text, std::string const &charset, method_type how=default_method)
	Convert a text from UTF to charset. More...
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (std::string const &text, std::locale const &loc, method_type how=default_method)
	Convert a text in locale encoding given by loc to UTF. More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (std::basic_string< CharType > const &text, std::locale const &loc, method_type how=default_method)
	Convert a text in UTF to locale encoding given by loc. More...
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (char const *text, std::locale const &loc, method_type how=default_method)
	Convert a text in locale encoding given by loc to UTF. More...
template<typename CharType >
std::string	boost::locale::conv::from_utf (CharType const *text, std::locale const &loc, method_type how=default_method)
	Convert a text in UTF to locale encoding given by loc. More...
BOOST_LOCALE_DECL std::string	boost::locale::conv::between (char const *begin, char const *end, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)
	Convert a text in range [begin,end) to to_encoding from from_encoding. More...
std::string	boost::locale::conv::between (char const *text, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)
	Convert a text to to_encoding from from_encoding. More...
std::string	boost::locale::conv::between (std::string const &text, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method)
	Convert a text to to_encoding from from_encoding. More...
template<typename CharOut , typename CharIn >
std::basic_string< CharOut >	boost::locale::conv::utf_to_utf (CharIn const *begin, CharIn const *end, method_type how=default_method)
	Convert a Unicode text in range [begin,end) to other Unicode encoding. More...
template<typename CharOut , typename CharIn >
std::basic_string< CharOut >	boost::locale::conv::utf_to_utf (CharIn const *str, method_type how=default_method)
	Convert a Unicode NUL terminated string str other Unicode encoding. More...
template<typename CharOut , typename CharIn >
std::basic_string< CharOut >	boost::locale::conv::utf_to_utf (std::basic_string< CharIn > const &str, method_type how=default_method)
	Convert a Unicode string str other Unicode encoding. More...

Detailed Description

Enumeration Type Documentation

enum boost::locale::conv::method_type

#include <boost_1_57_0/boost/locale/encoding_errors.hpp>

enum that defines conversion policy

Enumerator
skip	Skip illegal/unconvertable characters.
stop	Stop conversion and throw conversion_error.
default_method	Default method - skip.

Function Documentation

BOOST_LOCALE_DECL std::string boost::locale::conv::between	(	char const *	begin,
		char const *	end,
		std::string const &	to_encoding,
		std::string const &	from_encoding,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text in range [begin,end) to to_encoding from from_encoding.

Referenced by boost::locale::conv::between().

std::string boost::locale::conv::between ( char const *  text, std::string const &  to_encoding, std::string const &  from_encoding, method_type  how = default_method  )

inline

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text to to_encoding from from_encoding.

References boost::locale::conv::between(), and boost::iostreams::gzip::flags::text.

std::string boost::locale::conv::between ( std::string const &  text, std::string const &  to_encoding, std::string const &  from_encoding, method_type  how = default_method  )

inline

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text to to_encoding from from_encoding.

References boost::locale::conv::between().

template<typename CharType >

std::string boost::locale::conv::from_utf	(	CharType const *	begin,
		CharType const *	end,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

convert UTF text in range [begin,end) to a text encoded with charset according to policy how

Referenced by boost::locale::conv::from_utf().

template<typename CharType >

std::string boost::locale::conv::from_utf	(	CharType const *	begin,
		CharType const *	end,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

convert UTF text in range [begin,end) to a text encoded according to locale loc according to policy how

Note

throws std::bad_cast if the loc does not have info facet installed

References boost::locale::conv::from_utf().

template<typename CharType >

std::string boost::locale::conv::from_utf	(	std::basic_string< CharType > const &	text,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text from charset to UTF string.

References boost::locale::conv::from_utf().

template<typename CharType >

std::string boost::locale::conv::from_utf	(	CharType const *	text,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text from UTF to charset.

References boost::locale::conv::from_utf(), and boost::iostreams::gzip::flags::text.

template<typename CharType >

std::string boost::locale::conv::from_utf	(	std::basic_string< CharType > const &	text,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text in UTF to locale encoding given by loc.

Note

throws std::bad_cast if the loc does not have info facet installed

References boost::locale::conv::from_utf().

template<typename CharType >

std::string boost::locale::conv::from_utf	(	CharType const *	text,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text in UTF to locale encoding given by loc.

Note

throws std::bad_cast if the loc does not have info facet installed

References boost::locale::conv::from_utf(), and boost::iostreams::gzip::flags::text.

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	char const *	begin,
		char const *	end,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

convert string to UTF string from text in range [begin,end) encoded with charset according to policy how

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	char const *	begin,
		char const *	end,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

convert string to UTF string from text in range [begin,end) encoded according to locale loc according to policy how

Note

throws std::bad_cast if the loc does not have info facet installed

References boost::asio::begin, and boost::end.

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	std::string const &	text,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

convert a string text encoded with charset to UTF string

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	char const *	text,
		std::string const &	charset,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text from charset to UTF string.

References boost::iostreams::gzip::flags::text.

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	std::string const &	text,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text in locale encoding given by loc to UTF.

Note

throws std::bad_cast if the loc does not have info facet installed

template<typename CharType >

std::basic_string<CharType> boost::locale::conv::to_utf	(	char const *	text,
		std::locale const &	loc,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding.hpp>

Convert a text in locale encoding given by loc to UTF.

Note

throws std::bad_cast if the loc does not have info facet installed

References boost::iostreams::gzip::flags::text.

template<typename CharOut , typename CharIn >

std::basic_string<CharOut> boost::locale::conv::utf_to_utf	(	CharIn const *	begin,
		CharIn const *	end,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding_utf.hpp>

Convert a Unicode text in range [begin,end) to other Unicode encoding.

References boost::asio::begin, boost::multiprecision::backends::c, boost::end, boost::geometry::index::inserter(), and boost::locale::conv::stop.

template<typename CharOut , typename CharIn >

std::basic_string<CharOut> boost::locale::conv::utf_to_utf	(	CharIn const *	str,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding_utf.hpp>

Convert a Unicode NUL terminated string str other Unicode encoding.

References boost::end, and boost::str().

template<typename CharOut , typename CharIn >

std::basic_string<CharOut> boost::locale::conv::utf_to_utf	(	std::basic_string< CharIn > const &	str,
		method_type	how = default_method
	)

#include <boost_1_57_0/boost/locale/encoding_utf.hpp>

Convert a Unicode string str other Unicode encoding.