conversion functions

Functions
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const char *begin, const char *end, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const CharType *begin, const CharType *end, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const std::string &text, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const char *text, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const char *begin, const char *end, const std::locale &loc, method_type how=default_method)
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const std::string &text, const std::locale &loc, method_type how=default_method)
template<typename CharType >
std::basic_string< CharType >	boost::locale::conv::to_utf (const char *text, const std::locale &loc, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const std::basic_string< CharType > &text, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const CharType *text, const std::string &charset, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const CharType *begin, const CharType *end, const std::locale &loc, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const std::basic_string< CharType > &text, const std::locale &loc, method_type how=default_method)
template<typename CharType >
std::string	boost::locale::conv::from_utf (const CharType *text, const std::locale &loc, method_type how=default_method)
std::string	boost::locale::conv::between (const char *begin, const char *end, const std::string &to_encoding, const std::string &from_encoding, method_type how=default_method)
std::string	boost::locale::conv::between (const char *text, const std::string &to_encoding, const std::string &from_encoding, method_type how=default_method)
std::string	boost::locale::conv::between (const std::string &text, const std::string &to_encoding, const std::string &from_encoding, method_type how=default_method)

Detailed Description

Function Documentation

between() [1/3]

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

Convert a text in range [begin,end) to to_encoding from from_encoding according to policy how

Exceptions

invalid_charset_error	Either character set is not supported
conversion_error	when the conversion fails (e.g. how is stop and any character cannot be encoded or decoded)

between() [2/3]

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

inline

Convert text to to_encoding from from_encoding according to policy how

Exceptions

invalid_charset_error	Either character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

between() [3/3]

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

inline

Convert text to to_encoding from from_encoding according to policy how

Exceptions

invalid_charset_error	Either character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [1/6]

template<typename CharType >

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

Convert UTF text in range [begin,end) to text in locale encoding given by loc according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [2/6]

template<typename CharType >

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

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

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [3/6]

template<typename CharType >

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

Convert text from UTF to locale encoding given by loc according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [4/6]

template<typename CharType >

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

Convert text from UTF to charset according to policy how

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [5/6]

template<typename CharType >

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

Convert text from UTF to locale encoding given by loc according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

from_utf() [6/6]

template<typename CharType >

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

convert text from UTF to text encoded with charset according to policy how

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [1/6]

template<typename CharType >

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

convert text in range [begin,end) in locale encoding given by loc to UTF according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [2/6]

template<typename CharType >

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

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

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [3/6]

template<typename CharType >

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

Convert text in locale encoding given by loc to UTF according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [4/6]

template<typename CharType >

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

Convert text encoded with charset to UTF according to policy how

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [5/6]

template<typename CharType >

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

Convert text in locale encoding given by loc to UTF according to policy how

Exceptions

std::bad_cast	loc does not have info facet installed
invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)

to_utf() [6/6]

template<typename CharType >

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

convert text encoded with charset to UTF according to policy how

Exceptions

invalid_charset_error	Character set is not supported
conversion_error	Conversion failed (e.g. how is stop and any character cannot be encoded or decoded)