Boost.Locale: Character conversion functions

| | Boost.Locale |

• Main Page
• Related Pages
• Modules
• Namespaces
• Classes
• Files
• Examples

Classes | Enumerations | Functions

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](classboost_1_1locale_1_1conv_1_1invalid charset error.html) | | | This exception is thrown in case of use of unsupported or invalid character set. [More...](classboost_1_1locale_1_1conv_1_1invalid charset error.html#details)
| | |

|

Enumerations

| | enum | boost::locale::conv::method_type { boost::locale::conv::skip = 0, boost::locale::conv::stop = 1, boost::locale::conv::default_method = skip } | | |

|

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) | | | | 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) | | | | 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) | | | | 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) | | | | 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) | | | | 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) | | | | template<typename CharType > | | std::basic_string< CharType > | boost::locale::conv::to_utf (char const *text, std::string const &charset, method_type how=default_method) | | | | template<typename CharType > | | std::string | boost::locale::conv::from_utf (CharType const *text, std::string const &charset, method_type how=default_method) | | | | 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) | | | | 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) | | | | template<typename CharType > | | std::basic_string< CharType > | boost::locale::conv::to_utf (char const *text, std::locale const &loc, method_type how=default_method) | | | | template<typename CharType > | | std::string | boost::locale::conv::from_utf (CharType const *text, std::locale const &loc, method_type how=default_method) | | | | 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) | | | | std::string | boost::locale::conv::between (char const *text, std::string const &to_encoding, std::string const &from_encoding, method_type how=default_method) | | | | 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) | | | | 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) | | | | template<typename CharOut , typename CharIn > | | std::basic_string< CharOut > | boost::locale::conv::utf_to_utf (CharIn const *str, method_type how=default_method) | | | | 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) | | |

Detailed Description

Enumeration Type Documentation

| enum boost::locale::conv::method_type |

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

| 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

|

| 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 |

Convert a text to to_encoding from from_encoding

|

| 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 |

Convert a text to to_encoding from from_encoding

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

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

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

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

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

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

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

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

Notethrows 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 * | 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

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

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

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

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

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

Notethrows 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 | | | ) | | |

Convert a text in locale encoding given by loc to UTF

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

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

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

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

• © Copyright 2009-2012 Artyom Beilis, Distributed under the Boost Software License, Version 1.0.