From d5c19fcc1997ae29a2172c85ec1cbc12428cfd86 Mon Sep 17 00:00:00 2001 From: Artyom Beilis Date: Thu, 11 Aug 2011 10:11:54 +0000 Subject: [PATCH] Updated documentation [SVN r73646] --- doc/html/annotated.html | 1 + doc/html/charset_handling.html | 4 +- ..._1locale_1_1conv_1_1conversion__error.html | 8 +- ...le_1_1conv_1_1invalid__charset__error.html | 8 +- ..._1_1locale_1_1util_1_1base__converter.html | 8 +- doc/html/classes.html | 21 +- doc/html/config_8hpp_source.html | 72 +- doc/html/definitions_8hpp_source.html | 110 +++ doc/html/encoding_8hpp_source.html | 393 ++++------ doc/html/encoding__errors_8hpp_source.html | 135 ++++ doc/html/encoding__utf_8hpp_source.html | 155 ++++ doc/html/files.html | 4 + doc/html/functions_0x63.html | 21 +- doc/html/functions_0x64.html | 10 +- doc/html/functions_0x65.html | 11 +- doc/html/functions_0x69.html | 14 +- doc/html/functions_0x6d.html | 11 +- doc/html/functions_0x74.html | 3 + doc/html/functions_0x77.html | 7 +- doc/html/functions_func_0x64.html | 16 +- doc/html/functions_func_0x65.html | 8 +- doc/html/functions_func_0x69.html | 8 +- doc/html/functions_func_0x74.html | 5 +- doc/html/functions_func_0x77.html | 7 +- doc/html/functions_type.html | 1 + doc/html/functions_vars.html | 3 + doc/html/group__codepage.html | 679 +----------------- doc/html/hierarchy.html | 1 + doc/html/modules.html | 2 +- doc/html/namespaceboost_1_1locale.html | 10 +- .../namespaceboost_1_1locale_1_1conv.html | 142 ---- doc/html/namespaceboost_1_1locale_1_1utf.html | 119 +++ doc/html/namespacemembers_0x62.html | 3 - doc/html/namespacemembers_0x63.html | 3 + doc/html/namespacemembers_0x64.html | 14 +- doc/html/namespacemembers_0x66.html | 3 - doc/html/namespacemembers_0x69.html | 9 + doc/html/namespacemembers_0x6d.html | 7 +- doc/html/namespacemembers_0x73.html | 6 - doc/html/namespacemembers_0x74.html | 5 +- doc/html/namespacemembers_0x75.html | 3 - doc/html/namespacemembers_enum.html | 3 - doc/html/namespacemembers_eval.html | 83 +-- doc/html/namespacemembers_func.html | 1 - doc/html/namespacemembers_func_0x62.html | 4 - doc/html/namespacemembers_func_0x63.html | 1 - doc/html/namespacemembers_func_0x64.html | 1 - doc/html/namespacemembers_func_0x65.html | 1 - doc/html/namespacemembers_func_0x66.html | 6 +- doc/html/namespacemembers_func_0x67.html | 1 - doc/html/namespacemembers_func_0x68.html | 1 - doc/html/namespacemembers_func_0x69.html | 4 +- doc/html/namespacemembers_func_0x6a.html | 1 - doc/html/namespacemembers_func_0x6c.html | 1 - doc/html/namespacemembers_func_0x6d.html | 1 - doc/html/namespacemembers_func_0x6e.html | 1 - doc/html/namespacemembers_func_0x6f.html | 1 - doc/html/namespacemembers_func_0x70.html | 1 - doc/html/namespacemembers_func_0x73.html | 1 - doc/html/namespacemembers_func_0x74.html | 6 +- doc/html/namespacemembers_func_0x75.html | 114 --- doc/html/namespacemembers_func_0x77.html | 1 - doc/html/namespacemembers_func_0x79.html | 1 - doc/html/namespacemembers_type.html | 3 + doc/html/namespacemembers_vars.html | 6 + doc/html/namespaces.html | 2 +- ...1locale_1_1utf_1_1utf__traits-members.html | 88 +++ ...boost_1_1locale_1_1utf_1_1utf__traits.html | 357 +++++++++ doc/html/tree.html | 16 +- doc/html/utf_8hpp_source.html | 450 ++++++++++++ doc/html/util_8hpp_source.html | 147 ++-- 71 files changed, 1872 insertions(+), 1482 deletions(-) create mode 100644 doc/html/definitions_8hpp_source.html create mode 100644 doc/html/encoding__errors_8hpp_source.html create mode 100644 doc/html/encoding__utf_8hpp_source.html delete mode 100644 doc/html/namespaceboost_1_1locale_1_1conv.html create mode 100644 doc/html/namespaceboost_1_1locale_1_1utf.html delete mode 100644 doc/html/namespacemembers_func_0x75.html create mode 100644 doc/html/structboost_1_1locale_1_1utf_1_1utf__traits-members.html create mode 100644 doc/html/structboost_1_1locale_1_1utf_1_1utf__traits.html create mode 100644 doc/html/utf_8hpp_source.html diff --git a/doc/html/annotated.html b/doc/html/annotated.html index fbef5f9..12a65b3 100644 --- a/doc/html/annotated.html +++ b/doc/html/annotated.html @@ -106,6 +106,7 @@ Here are the classes, structs, unions and interfaces with brief descriptions:boost::locale::posix_time boost::locale::boundary::segment< IteratorType >Segment object that represents a pair of two iterators that define the range where this segment exits and a rule that defines it boost::locale::boundary::segment_index< BaseIterator >This class holds an index of segments in the text range and allows to iterate over them + boost::locale::utf::utf_traits< CharType, size >UTF Traits class - functions to convert UTF sequences to and from Unicode code points
diff --git a/doc/html/charset_handling.html b/doc/html/charset_handling.html index 22158d7..25adbef 100644 --- a/doc/html/charset_handling.html +++ b/doc/html/charset_handling.html @@ -71,11 +71,11 @@

Convenience Interface

-

Boost.Locale provides to_utf, from_utf and utf_to_utf functions in the boost::locale::conv namespace. They are simple and convenient functions to convert a string to and from UTF-8/16/32 strings and strings using other encodings.

+

Boost.Locale provides to_utf, from_utf and utf_to_utf functions in the boost::locale::conv namespace. They are simple and convenient functions to convert a string to and from UTF-8/16/32 strings and strings using other encodings.

For example:

std::string utf8_string = to_utf<char>(latin1_string,"Latin1");
 std::wstring wide_string = to_utf<wchar_t>(latin1_string,"Latin1");
-std::string latin1_string = from_utf(wide_string,"Latin1");
+std::string latin1_string = from_utf(wide_string,"Latin1");
 std::string utf8_string2 = utf_to_utf<char>(wide_string);

This function may use an explicit encoding name like "Latin1" or "ISO-8859-8", or use std::locale as a parameter to fetch this information from it. It also receives a policy parameter that tells it how to behave if the conversion can't be performed (i.e. an illegal or unsupported character is found). By default this function skips all illegal characters and tries to do the best it can, however, it is possible ask it to throw a conversion_error exception by passing the stop flag to it:

std::wstring s=to_utf<wchar_t>("\xFF\xFF","UTF-8",stop); 
diff --git a/doc/html/classboost_1_1locale_1_1conv_1_1conversion__error.html b/doc/html/classboost_1_1locale_1_1conv_1_1conversion__error.html
index 1947456..07e976a 100644
--- a/doc/html/classboost_1_1locale_1_1conv_1_1conversion__error.html
+++ b/doc/html/classboost_1_1locale_1_1conv_1_1conversion__error.html
@@ -68,7 +68,7 @@
@@ -77,7 +77,7 @@

boost::locale::conv::conversion_error Class Reference
-[Character conversion functions] +[Codepage]

@@ -85,7 +85,7 @@

The excepton that is thrown in case of conversion error. More...

-

#include <boost/locale/encoding.hpp>

+

#include <boost/locale/encoding_errors.hpp>

List of all members.

@@ -93,7 +93,7 @@

Detailed Description

The excepton that is thrown in case of conversion error.

The documentation for this class was generated from the following file:
diff --git a/doc/html/classboost_1_1locale_1_1conv_1_1invalid__charset__error.html b/doc/html/classboost_1_1locale_1_1conv_1_1invalid__charset__error.html index ebcc882..8907608 100644 --- a/doc/html/classboost_1_1locale_1_1conv_1_1invalid__charset__error.html +++ b/doc/html/classboost_1_1locale_1_1conv_1_1invalid__charset__error.html @@ -68,7 +68,7 @@ @@ -79,7 +79,7 @@

boost::locale::conv::invalid_charset_error Class Reference
-[Character conversion functions] +[Codepage]

@@ -87,7 +87,7 @@

This exception is thrown in case of use of unsupported or invalid character set. More...

-

#include <boost/locale/encoding.hpp>

+

#include <boost/locale/encoding_errors.hpp>

List of all members.

@@ -100,7 +100,7 @@ Public Member Functions

Detailed Description

This exception is thrown in case of use of unsupported or invalid character set.

The documentation for this class was generated from the following file:
diff --git a/doc/html/classboost_1_1locale_1_1util_1_1base__converter.html b/doc/html/classboost_1_1locale_1_1util_1_1base__converter.html index 4fc6fda..f8b5e65 100644 --- a/doc/html/classboost_1_1locale_1_1util_1_1base__converter.html +++ b/doc/html/classboost_1_1locale_1_1util_1_1base__converter.html @@ -98,8 +98,8 @@ Public Member Functions
- - + +
virtual uint32_t from_unicode (uint32_t u, char *begin, char const *end)

Static Public Attributes

static const uint32_t illegal = 0xFFFFFFFF
static const uint32_t incomplete = 0xFFFFFFFE
static const uint32_t illegal = utf::illegal
static const uint32_t incomplete = utf::incomplete

Detailed Description

This class represent a simple stateless converter from UCS-4 and to UCS-4 for each single code point.

@@ -238,7 +238,7 @@ Static Public Attributes
- +
const uint32_t boost::locale::util::base_converter::illegal = 0xFFFFFFFF [static]const uint32_t boost::locale::util::base_converter::illegal = utf::illegal [static]
@@ -252,7 +252,7 @@ Static Public Attributes
- +
const uint32_t boost::locale::util::base_converter::incomplete = 0xFFFFFFFE [static]const uint32_t boost::locale::util::base_converter::incomplete = utf::incomplete [static]
diff --git a/doc/html/classes.html b/doc/html/classes.html index f9d1f27..b5412a2 100644 --- a/doc/html/classes.html +++ b/doc/html/classes.html @@ -70,20 +70,21 @@

Class Index

-
A | B | C | D | G | H | I | L | M | P | S
+
A | B | C | D | G | H | I | L | M | P | S | U
  A  
  C  
-
  D  
-
  H  
-
  M  
-
abstract_calendar (boost::locale)   calendar (boost::locale)   date_time (boost::locale)   hold_ptr (boost::locale)   message_format (boost::locale)   
  B  
-		calendar_facet (boost::locale)   date_time_duration (boost::locale)   
  I  
-		messages_info (boost::locale::gnu_gettext)   
base_converter (boost::locale::util)   collator (boost::locale)   date_time_error (boost::locale)   info (boost::locale)   
  P  
-
basic_format (boost::locale)   collator_base (boost::locale)   date_time_period (boost::locale)   invalid_charset_error (boost::locale::conv)   period_type (boost::locale::period)   
basic_message (boost::locale)   comparator (boost::locale)   date_time_period_set (boost::locale)   ios_info (boost::locale)   posix_time (boost::locale)   
boundary_indexing (boost::locale::boundary)   conversion_error (boost::locale::conv)   messages_info::domain (boost::locale::gnu_gettext)   
  L  
+		date_time (boost::locale)   
  I  
+		messages_info (boost::locale::gnu_gettext)   
abstract_calendar (boost::locale)   calendar (boost::locale)   date_time_duration (boost::locale)   info (boost::locale)   
  P  
+
  B  
+		calendar_facet (boost::locale)   date_time_error (boost::locale)   invalid_charset_error (boost::locale::conv)   period_type (boost::locale::period)   
base_converter (boost::locale::util)   collator (boost::locale)   date_time_period (boost::locale)   ios_info (boost::locale)   posix_time (boost::locale)   
basic_format (boost::locale)   collator_base (boost::locale)   date_time_period_set (boost::locale)   
  L  
  S  
-
boundary_point (boost::locale::boundary)   converter (boost::locale)   
  G  
-		localization_backend (boost::locale)   segment (boost::locale::boundary)   
boundary_point_index (boost::locale::boundary)   converter_base (boost::locale)   generator (boost::locale)   localization_backend_manager (boost::locale)   segment_index (boost::locale::boundary)   
break_info (boost::locale::boundary)   
A | B | C | D | G | H | I | L | M | P | S
+basic_message (boost::locale)   comparator (boost::locale)   messages_info::domain (boost::locale::gnu_gettext)   localization_backend (boost::locale)   segment (boost::locale::boundary)   boundary_indexing (boost::locale::boundary)   conversion_error (boost::locale::conv)   
  G  
+localization_backend_manager (boost::locale)   segment_index (boost::locale::boundary)   boundary_point (boost::locale::boundary)   converter (boost::locale)   generator (boost::locale)   
  M  
+
  U  
+boundary_point_index (boost::locale::boundary)   converter_base (boost::locale)   
  H  
+message_format (boost::locale)   utf_traits (boost::locale::utf)   break_info (boost::locale::boundary)   
  D  
+hold_ptr (boost::locale)   
A | B | C | D | G | H | I | L | M | P | S | U
© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. diff --git a/doc/html/config_8hpp_source.html b/doc/html/config_8hpp_source.html index add36ce..6629455 100644 --- a/doc/html/config_8hpp_source.html +++ b/doc/html/config_8hpp_source.html @@ -77,53 +77,33 @@ 00008 #ifndef BOOST_LOCALE_CONFIG_HPP_INCLUDED 00009 #define BOOST_LOCALE_CONFIG_HPP_INCLUDED 00010 -00011 #include <boost/config.hpp> +00011 #include <boost/locale/definitions.hpp> 00012 -00013 // Support older ICU versions -00014 #ifndef BOOST_SYMBOL_VISIBLE -00015 # define BOOST_SYMBOL_VISIBLE -00016 #endif -00017 -00018 #ifdef BOOST_HAS_DECLSPEC -00019 # if defined(BOOST_ALL_DYN_LINK) || defined(BOOST_LOCALE_DYN_LINK) -00020 # ifdef BOOST_LOCALE_SOURCE -00021 # define BOOST_LOCALE_DECL BOOST_SYMBOL_EXPORT -00022 # else -00023 # define BOOST_LOCALE_DECL BOOST_SYMBOL_IMPORT -00024 # endif // BOOST_LOCALE_SOURCE -00025 # endif // DYN_LINK -00026 #endif // BOOST_HAS_DECLSPEC -00027 -00028 #ifndef BOOST_LOCALE_DECL -00029 # define BOOST_LOCALE_DECL -00030 #endif -00031 -00032 // -00033 // Automatically link to the correct build variant where possible. -00034 // -00035 #if !defined(BOOST_ALL_NO_LIB) && !defined(BOOST_LOCALE_NO_LIB) && !defined(BOOST_LOCALE_SOURCE) -00036 // -00037 // Set the name of our library, this will get undef'ed by auto_link.hpp -00038 // once it's done with it: -00039 // -00040 #define BOOST_LIB_NAME boost_locale -00041 // -00042 // If we're importing code from a dll, then tell auto_link.hpp about it: -00043 // -00044 #if defined(BOOST_ALL_DYN_LINK) || defined(BOOST_LOCALE_DYN_LINK) -00045 # define BOOST_DYN_LINK -00046 #endif -00047 // -00048 // And include the header that does the work: -00049 // -00050 #include <boost/config/auto_link.hpp> -00051 #endif // auto-linking disabled -00052 -00053 -00054 -00055 #endif // boost/locale/config.hpp -00056 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 -00057 +00013 // +00014 // Automatically link to the correct build variant where possible. +00015 // +00016 #if !defined(BOOST_ALL_NO_LIB) && !defined(BOOST_LOCALE_NO_LIB) && !defined(BOOST_LOCALE_SOURCE) +00017 // +00018 // Set the name of our library, this will get undef'ed by auto_link.hpp +00019 // once it's done with it: +00020 // +00021 #define BOOST_LIB_NAME boost_locale +00022 // +00023 // If we're importing code from a dll, then tell auto_link.hpp about it: +00024 // +00025 #if defined(BOOST_ALL_DYN_LINK) || defined(BOOST_LOCALE_DYN_LINK) +00026 # define BOOST_DYN_LINK +00027 #endif +00028 // +00029 // And include the header that does the work: +00030 // +00031 #include <boost/config/auto_link.hpp> +00032 #endif // auto-linking disabled +00033 +00034 +00035 #endif // boost/locale/config.hpp +00036 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +00037
diff --git a/doc/html/definitions_8hpp_source.html b/doc/html/definitions_8hpp_source.html new file mode 100644 index 0000000..833e8ed --- /dev/null +++ b/doc/html/definitions_8hpp_source.html @@ -0,0 +1,110 @@ + + + + +Boost.Locale: boost/locale/definitions.hpp Source File + + + + + + +
+
+
+ +

+ + + + Boost + C++ Libraries + +

+ +

+ + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

+
+
+ +
+ + +
+© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
+ + diff --git a/doc/html/encoding_8hpp_source.html b/doc/html/encoding_8hpp_source.html index 8e2180b..58e2cba 100644 --- a/doc/html/encoding_8hpp_source.html +++ b/doc/html/encoding_8hpp_source.html @@ -83,255 +83,170 @@ 00014 # pragma warning(disable : 4275 4251 4231 4660) 00015 #endif 00016 #include <boost/locale/info.hpp> -00017 #include <boost/cstdint.hpp> -00018 #include <stdexcept> +00017 #include <boost/locale/encoding_errors.hpp> +00018 #include <boost/locale/encoding_utf.hpp> 00019 00020 00021 00022 namespace boost { 00023 namespace locale { 00024 -00028 namespace conv { +00028 namespace conv { 00033 -00037 class BOOST_SYMBOL_VISIBLE conversion_error : public std::runtime_error { -00038 public: -00039 conversion_error() : std::runtime_error("Conversion failed") {} -00040 }; -00041 -00046 class BOOST_SYMBOL_VISIBLE invalid_charset_error : public std::runtime_error { -00047 public: -00048 -00050 invalid_charset_error(std::string charset) : -00051 std::runtime_error("Invalid or unsupported charset:" + charset) -00052 { -00053 } -00054 }; -00055 +00037 template<typename CharType> +00038 std::basic_string<CharType> to_utf(char const *begin,char const *end,std::string const &charset,method_type how=default_method); +00039 +00043 template<typename CharType> +00044 std::string from_utf(CharType const *begin,CharType const *end,std::string const &charset,method_type how=default_method); +00045 +00051 template<typename CharType> +00052 std::basic_string<CharType> to_utf(char const *begin,char const *end,std::locale const &loc,method_type how=default_method) +00053 { +00054 return to_utf<CharType>(begin,end,std::use_facet<info>(loc).encoding(),how); +00055 } 00056 -00060 typedef enum { -00061 skip = 0, -00062 stop = 1, -00063 default_method = skip -00064 } method_type; -00065 -00069 template<typename CharType> -00070 std::basic_string<CharType> to_utf(char const *begin,char const *end,std::string const &charset,method_type how=default_method); -00071 -00075 template<typename CharType> -00076 std::string from_utf(CharType const *begin,CharType const *end,std::string const &charset,method_type how=default_method); +00062 template<typename CharType> +00063 std::string from_utf(CharType const *begin,CharType const *end,std::locale const &loc,method_type how=default_method) +00064 { +00065 return from_utf(begin,end,std::use_facet<info>(loc).encoding(),how); +00066 } +00067 +00071 +00072 template<typename CharType> +00073 std::basic_string<CharType> to_utf(std::string const &text,std::string const &charset,method_type how=default_method) +00074 { +00075 return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),charset,how); +00076 } 00077 -00083 template<typename CharType> -00084 std::basic_string<CharType> to_utf(char const *begin,char const *end,std::locale const &loc,method_type how=default_method) -00085 { -00086 return to_utf<CharType>(begin,end,std::use_facet<info>(loc).encoding(),how); -00087 } -00088 -00094 template<typename CharType> -00095 std::string from_utf(CharType const *begin,CharType const *end,std::locale const &loc,method_type how=default_method) -00096 { -00097 return from_utf(begin,end,std::use_facet<info>(loc).encoding(),how); -00098 } -00099 -00103 -00104 template<typename CharType> -00105 std::basic_string<CharType> to_utf(std::string const &text,std::string const &charset,method_type how=default_method) -00106 { -00107 return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),charset,how); -00108 } -00109 -00113 template<typename CharType> -00114 std::string from_utf(std::basic_string<CharType> const &text,std::string const &charset,method_type how=default_method) -00115 { -00116 return from_utf(text.c_str(),text.c_str()+text.size(),charset,how); -00117 } -00118 -00122 template<typename CharType> -00123 std::basic_string<CharType> to_utf(char const *text,std::string const &charset,method_type how=default_method) -00124 { -00125 char const *text_end = text; -00126 while(*text_end) -00127 text_end++; -00128 return to_utf<CharType>(text,text_end,charset,how); -00129 } -00130 -00134 template<typename CharType> -00135 std::string from_utf(CharType const *text,std::string const &charset,method_type how=default_method) -00136 { -00137 CharType const *text_end = text; -00138 while(*text_end) -00139 text_end++; -00140 return from_utf(text,text_end,charset,how); -00141 } -00142 -00148 template<typename CharType> -00149 std::basic_string<CharType> to_utf(std::string const &text,std::locale const &loc,method_type how=default_method) -00150 { -00151 return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),loc,how); -00152 } -00153 -00159 template<typename CharType> -00160 std::string from_utf(std::basic_string<CharType> const &text,std::locale const &loc,method_type how=default_method) -00161 { -00162 return from_utf(text.c_str(),text.c_str()+text.size(),loc,how); -00163 } -00164 -00170 template<typename CharType> -00171 std::basic_string<CharType> to_utf(char const *text,std::locale const &loc,method_type how=default_method) -00172 { -00173 char const *text_end = text; -00174 while(*text_end) -00175 text_end++; -00176 return to_utf<CharType>(text,text_end,loc,how); -00177 } -00178 -00184 template<typename CharType> -00185 std::string from_utf(CharType const *text,std::locale const &loc,method_type how=default_method) -00186 { -00187 CharType const *text_end = text; -00188 while(*text_end) -00189 text_end++; -00190 return from_utf(text,text_end,loc,how); -00191 } -00192 -00193 -00197 -00198 BOOST_LOCALE_DECL -00199 std::string between(char const *begin, -00200 char const *end, -00201 std::string const &to_encoding, -00202 std::string const &from_encoding, -00203 method_type how=default_method); -00204 -00208 -00209 inline -00210 std::string between(char const *text, -00211 std::string const &to_encoding, -00212 std::string const &from_encoding, -00213 method_type how=default_method) -00214 { -00215 char const *end=text; -00216 while(*end) -00217 end++; -00218 return boost::locale::conv::between(text,end,to_encoding,from_encoding,how); -00219 } -00220 -00224 inline -00225 std::string between(std::string const &text, -00226 std::string const &to_encoding, -00227 std::string const &from_encoding, -00228 method_type how=default_method) -00229 { -00230 return boost::locale::conv::between(text.c_str(),text.c_str()+text.size(),to_encoding,from_encoding,how); -00231 } -00232 -00234 -00235 template<> -00236 BOOST_LOCALE_DECL std::basic_string<char> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); -00237 -00238 template<> -00239 BOOST_LOCALE_DECL std::string from_utf(char const *begin,char const *end,std::string const &charset,method_type how); -00240 -00241 template<> -00242 BOOST_LOCALE_DECL std::basic_string<wchar_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); -00243 -00244 template<> -00245 BOOST_LOCALE_DECL std::string from_utf(wchar_t const *begin,wchar_t const *end,std::string const &charset,method_type how); +00081 template<typename CharType> +00082 std::string from_utf(std::basic_string<CharType> const &text,std::string const &charset,method_type how=default_method) +00083 { +00084 return from_utf(text.c_str(),text.c_str()+text.size(),charset,how); +00085 } +00086 +00090 template<typename CharType> +00091 std::basic_string<CharType> to_utf(char const *text,std::string const &charset,method_type how=default_method) +00092 { +00093 char const *text_end = text; +00094 while(*text_end) +00095 text_end++; +00096 return to_utf<CharType>(text,text_end,charset,how); +00097 } +00098 +00102 template<typename CharType> +00103 std::string from_utf(CharType const *text,std::string const &charset,method_type how=default_method) +00104 { +00105 CharType const *text_end = text; +00106 while(*text_end) +00107 text_end++; +00108 return from_utf(text,text_end,charset,how); +00109 } +00110 +00116 template<typename CharType> +00117 std::basic_string<CharType> to_utf(std::string const &text,std::locale const &loc,method_type how=default_method) +00118 { +00119 return to_utf<CharType>(text.c_str(),text.c_str()+text.size(),loc,how); +00120 } +00121 +00127 template<typename CharType> +00128 std::string from_utf(std::basic_string<CharType> const &text,std::locale const &loc,method_type how=default_method) +00129 { +00130 return from_utf(text.c_str(),text.c_str()+text.size(),loc,how); +00131 } +00132 +00138 template<typename CharType> +00139 std::basic_string<CharType> to_utf(char const *text,std::locale const &loc,method_type how=default_method) +00140 { +00141 char const *text_end = text; +00142 while(*text_end) +00143 text_end++; +00144 return to_utf<CharType>(text,text_end,loc,how); +00145 } +00146 +00152 template<typename CharType> +00153 std::string from_utf(CharType const *text,std::locale const &loc,method_type how=default_method) +00154 { +00155 CharType const *text_end = text; +00156 while(*text_end) +00157 text_end++; +00158 return from_utf(text,text_end,loc,how); +00159 } +00160 +00161 +00165 +00166 BOOST_LOCALE_DECL +00167 std::string between(char const *begin, +00168 char const *end, +00169 std::string const &to_encoding, +00170 std::string const &from_encoding, +00171 method_type how=default_method); +00172 +00176 +00177 inline +00178 std::string between(char const *text, +00179 std::string const &to_encoding, +00180 std::string const &from_encoding, +00181 method_type how=default_method) +00182 { +00183 char const *end=text; +00184 while(*end) +00185 end++; +00186 return boost::locale::conv::between(text,end,to_encoding,from_encoding,how); +00187 } +00188 +00192 inline +00193 std::string between(std::string const &text, +00194 std::string const &to_encoding, +00195 std::string const &from_encoding, +00196 method_type how=default_method) +00197 { +00198 return boost::locale::conv::between(text.c_str(),text.c_str()+text.size(),to_encoding,from_encoding,how); +00199 } +00200 +00202 +00203 template<> +00204 BOOST_LOCALE_DECL std::basic_string<char> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); +00205 +00206 template<> +00207 BOOST_LOCALE_DECL std::string from_utf(char const *begin,char const *end,std::string const &charset,method_type how); +00208 +00209 template<> +00210 BOOST_LOCALE_DECL std::basic_string<wchar_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); +00211 +00212 template<> +00213 BOOST_LOCALE_DECL std::string from_utf(wchar_t const *begin,wchar_t const *end,std::string const &charset,method_type how); +00214 +00215 #ifdef BOOST_HAS_CHAR16_T +00216 template<> +00217 BOOST_LOCALE_DECL std::basic_string<char16_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); +00218 +00219 template<> +00220 BOOST_LOCALE_DECL std::string from_utf(char16_t const *begin,char16_t const *end,std::string const &charset,method_type how); +00221 #endif +00222 +00223 #ifdef BOOST_HAS_CHAR32_T +00224 template<> +00225 BOOST_LOCALE_DECL std::basic_string<char32_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); +00226 +00227 template<> +00228 BOOST_LOCALE_DECL std::string from_utf(char32_t const *begin,char32_t const *end,std::string const &charset,method_type how); +00229 #endif +00230 +00231 +00233 +00234 } // conv +00235 +00236 } // locale +00237 } // boost +00238 +00239 #ifdef BOOST_MSVC +00240 #pragma warning(pop) +00241 #endif +00242 +00243 #endif +00244 +00245 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 00246 -00247 #ifdef BOOST_HAS_CHAR16_T -00248 template<> -00249 BOOST_LOCALE_DECL std::basic_string<char16_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); -00250 -00251 template<> -00252 BOOST_LOCALE_DECL std::string from_utf(char16_t const *begin,char16_t const *end,std::string const &charset,method_type how); -00253 #endif -00254 -00255 #ifdef BOOST_HAS_CHAR32_T -00256 template<> -00257 BOOST_LOCALE_DECL std::basic_string<char32_t> to_utf(char const *begin,char const *end,std::string const &charset,method_type how); -00258 -00259 template<> -00260 BOOST_LOCALE_DECL std::string from_utf(char32_t const *begin,char32_t const *end,std::string const &charset,method_type how); -00261 #endif -00262 -00263 namespace details { -00264 -00265 template<typename CharOut,typename CharIn> -00266 struct utf_to_utf_traits { -00267 static std::basic_string<CharOut> -00268 convert(CharIn const *begin,CharIn const *end,method_type how) -00269 { -00270 // Make more efficient in fututre - UTF-16/UTF-32 should be quite -00271 // simple and fast -00272 return to_utf<CharOut>(from_utf(begin,end,"UTF-8",how),"UTF-8",how); -00273 } -00274 }; -00275 template<typename CharOut> -00276 struct utf_to_utf_traits<CharOut,char> { -00277 static std::basic_string<CharOut> -00278 convert(char const *begin,char const *end,method_type how) -00279 { -00280 return to_utf<CharOut>(begin,end,"UTF-8",how); -00281 } -00282 }; -00283 template<typename CharIn> -00284 struct utf_to_utf_traits<char,CharIn> { -00285 static std::string -00286 convert(CharIn const *begin,CharIn const *end,method_type how) -00287 { -00288 return from_utf(begin,end,"UTF-8",how); -00289 } -00290 }; -00291 template<> -00292 struct utf_to_utf_traits<char,char> { // just test valid -00293 static std::string -00294 convert(char const *begin,char const *end,method_type how) -00295 { -00296 return from_utf(begin,end,"UTF-8",how); -00297 } -00298 }; -00299 } -00300 -00302 -00306 template<typename CharOut,typename CharIn> -00307 std::basic_string<CharOut> -00308 utf_to_utf(CharIn const *begin,CharIn const *end,method_type how = default_method) -00309 { -00310 return details::utf_to_utf_traits<CharOut,CharIn>::convert(begin,end,how); -00311 } -00312 -00316 template<typename CharOut,typename CharIn> -00317 std::basic_string<CharOut> -00318 utf_to_utf(CharIn const *str,method_type how = default_method) -00319 { -00320 CharIn const *end = str; -00321 while(*end) -00322 end++; -00323 return utf_to_utf<CharOut,CharIn>(str,end,how); -00324 } -00325 -00326 -00330 template<typename CharOut,typename CharIn> -00331 std::basic_string<CharOut> -00332 utf_to_utf(std::basic_string<CharIn> const &str,method_type how = default_method) -00333 { -00334 return utf_to_utf<CharOut,CharIn>(str.c_str(),str.c_str()+str.size(),how); -00335 } -00336 -00337 -00339 -00340 } // conv -00341 -00342 } // locale -00343 } // boost -00344 -00345 #ifdef BOOST_MSVC -00346 #pragma warning(pop) -00347 #endif -00348 -00349 #endif -00350 -00351 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 -00352
diff --git a/doc/html/encoding__errors_8hpp_source.html b/doc/html/encoding__errors_8hpp_source.html new file mode 100644 index 0000000..d64576b --- /dev/null +++ b/doc/html/encoding__errors_8hpp_source.html @@ -0,0 +1,135 @@ + + + + +Boost.Locale: boost/locale/encoding_errors.hpp Source File + + + + + + +
+
+
+ +

+ + + + Boost + C++ Libraries + +

+ +

+ + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

+
+
+ +
+ + +
+© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
+ + diff --git a/doc/html/encoding__utf_8hpp_source.html b/doc/html/encoding__utf_8hpp_source.html new file mode 100644 index 0000000..d9966b5 --- /dev/null +++ b/doc/html/encoding__utf_8hpp_source.html @@ -0,0 +1,155 @@ + + + + +Boost.Locale: boost/locale/encoding_utf.hpp Source File + + + + + + +
+
+
+ +

+ + + + Boost + C++ Libraries + +

+ +

+ + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

+
+
+ +
+ + +
+© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
+ + diff --git a/doc/html/files.html b/doc/html/files.html index f685947..7de2b98 100644 --- a/doc/html/files.html +++ b/doc/html/files.html @@ -75,7 +75,10 @@ Here is a list of all documented files with brief descriptions: + + + @@ -85,6 +88,7 @@ Here is a list of all documented files with brief descriptions:
boost/locale/conversion.hpp [code]
boost/locale/date_time.hpp [code]
boost/locale/date_time_facet.hpp [code]
boost/locale/definitions.hpp [code]
boost/locale/encoding.hpp [code]
boost/locale/encoding_errors.hpp [code]
boost/locale/encoding_utf.hpp [code]
boost/locale/format.hpp [code]
boost/locale/formatting.hpp [code]
boost/locale/generator.hpp [code]
+ diff --git a/doc/html/functions_0x63.html b/doc/html/functions_0x63.html index 221b6d2..276c194 100644 --- a/doc/html/functions_0x63.html +++ b/doc/html/functions_0x63.html @@ -129,6 +129,7 @@ Here is a list of all documented class members with links to the class documenta
  • char_type : boost::locale::message_format< CharType > , boost::locale::basic_message< CharType > +, boost::locale::utf::utf_traits< CharType, size > , boost::locale::boundary::segment< IteratorType > , boost::locale::collator< CharType > , boost::locale::basic_format< CharType > @@ -150,8 +151,8 @@ Here is a list of all documented class members with links to the class documenta : boost::locale::generator
  • clone() -: boost::locale::localization_backend -, boost::locale::abstract_calendar +: boost::locale::abstract_calendar +, boost::locale::localization_backend , boost::locale::util::base_converter
  • collator() @@ -161,26 +162,26 @@ Here is a list of all documented class members with links to the class documenta : boost::locale::comparator< CharType, default_level >
  • compare() -: boost::locale::collator< CharType > +: boost::locale::collator< CharType >
  • const_iterator : boost::locale::boundary::segment_index< BaseIterator > -, boost::locale::boundary::boundary_point_index< BaseIterator > , boost::locale::boundary::segment< IteratorType > +, boost::locale::boundary::boundary_point_index< BaseIterator >
  • conversion_type : boost::locale::converter_base
  • convert() -: boost::locale::message_format< CharType > -, boost::locale::converter< Char > +: boost::locale::converter< Char > +, boost::locale::message_format< CharType >
  • converter() : boost::locale::converter< Char >
    • -
  • country() -: boost::locale::info -, boost::locale::gnu_gettext::messages_info +
  • country +: boost::locale::gnu_gettext::messages_info +, boost::locale::info
  • country_property : boost::locale::info @@ -189,7 +190,7 @@ Here is a list of all documented class members with links to the class documenta : boost::locale::calendar_facet
  • currency_flags() -: boost::locale::ios_info +: boost::locale::ios_info
  • current : boost::locale::abstract_calendar diff --git a/doc/html/functions_0x64.html b/doc/html/functions_0x64.html index 277b98d..eddd64e 100644 --- a/doc/html/functions_0x64.html +++ b/doc/html/functions_0x64.html @@ -129,6 +129,12 @@ Here is a list of all documented class members with links to the class documenta
  • datetime_flags() : boost::locale::ios_info
    • +
  • decode() +: boost::locale::utf::utf_traits< CharType, size > +
    • +
  • decode_valid() +: boost::locale::utf::utf_traits< CharType, size > +
  • difference() : boost::locale::date_time , boost::locale::abstract_calendar @@ -140,13 +146,13 @@ Here is a list of all documented class members with links to the class documenta : boost::locale::ios_info
  • do_compare() -: boost::locale::collator< CharType > +: boost::locale::collator< CharType >
  • do_hash() : boost::locale::collator< CharType >
  • do_transform() -: boost::locale::collator< CharType > +: boost::locale::collator< CharType >
  • domain() : boost::locale::message_format< CharType > diff --git a/doc/html/functions_0x65.html b/doc/html/functions_0x65.html index b9fa0c8..582f1eb 100644 --- a/doc/html/functions_0x65.html +++ b/doc/html/functions_0x65.html @@ -108,19 +108,22 @@ Here is a list of all documented class members with links to the class documenta
  • empty() : boost::locale::boundary::segment< IteratorType >
    • +
  • encode() +: boost::locale::utf::utf_traits< CharType, size > +
  • encoding -: boost::locale::gnu_gettext::messages_info +: boost::locale::gnu_gettext::messages_info::domain , boost::locale::info -, boost::locale::gnu_gettext::messages_info::domain +, boost::locale::gnu_gettext::messages_info
  • encoding_property : boost::locale::info
  • end() -: boost::locale::date_time_duration +: boost::locale::boundary::segment_index< BaseIterator > , boost::locale::boundary::segment< IteratorType > +, boost::locale::date_time_duration , boost::locale::boundary::boundary_point_index< BaseIterator > -, boost::locale::boundary::segment_index< BaseIterator >
    • diff --git a/doc/html/functions_0x69.html b/doc/html/functions_0x69.html index e3788ab..b28706d 100644 --- a/doc/html/functions_0x69.html +++ b/doc/html/functions_0x69.html @@ -142,15 +142,21 @@ Here is a list of all documented class members with links to the class documenta
  • is_in_daylight_saving_time() : boost::locale::date_time
    • +
  • is_lead() +: boost::locale::utf::utf_traits< CharType, size > +
  • is_thread_safe() : boost::locale::util::base_converter
    • +
  • is_trail() +: boost::locale::utf::utf_traits< CharType, size > +
  • iterator -: boost::locale::boundary::boundary_point_index< BaseIterator > -, boost::locale::boundary::boundary_point< IteratorType > -, boost::locale::boundary::segment_index< BaseIterator > -, boost::locale::boundary::segment< IteratorType > +: boost::locale::boundary::segment_index< BaseIterator > +, boost::locale::boundary::boundary_point_index< BaseIterator > , boost::locale::boundary::boundary_point< IteratorType > +, boost::locale::boundary::segment< IteratorType > +, boost::locale::boundary::boundary_point< IteratorType >
  • iterator_type : boost::locale::boundary::boundary_point< IteratorType > diff --git a/doc/html/functions_0x6d.html b/doc/html/functions_0x6d.html index 262587a..13b317a 100644 --- a/doc/html/functions_0x6d.html +++ b/doc/html/functions_0x6d.html @@ -116,9 +116,12 @@ Here is a list of all documented class members with links to the class documenta
  • max_len() : boost::locale::util::base_converter
    • +
  • max_width +: boost::locale::utf::utf_traits< CharType, size > +
  • maximum() -: boost::locale::calendar -, boost::locale::date_time +: boost::locale::date_time +, boost::locale::calendar
  • message_format() : boost::locale::message_format< CharType > @@ -127,8 +130,8 @@ Here is a list of all documented class members with links to the class documenta : boost::locale::basic_format< CharType >
  • minimum() -: boost::locale::calendar -, boost::locale::date_time +: boost::locale::date_time +, boost::locale::calendar
  • move : boost::locale::abstract_calendar diff --git a/doc/html/functions_0x74.html b/doc/html/functions_0x74.html index 15547c6..dbc4dee 100644 --- a/doc/html/functions_0x74.html +++ b/doc/html/functions_0x74.html @@ -123,6 +123,9 @@ Here is a list of all documented class members with links to the class documenta
  • to_unicode() : boost::locale::util::base_converter
    • +
  • trail_length() +: boost::locale::utf::utf_traits< CharType, size > +
  • transform() : boost::locale::collator< CharType >
    • diff --git a/doc/html/functions_0x77.html b/doc/html/functions_0x77.html index 342cc98..4d22fac 100644 --- a/doc/html/functions_0x77.html +++ b/doc/html/functions_0x77.html @@ -105,9 +105,12 @@ Here is a list of all documented class members with links to the class documentation for each member:

    - w -

    diff --git a/doc/html/functions_func_0x64.html b/doc/html/functions_func_0x64.html index 1fcda1f..a92919a 100644 --- a/doc/html/functions_func_0x64.html +++ b/doc/html/functions_func_0x64.html @@ -128,28 +128,34 @@
  • datetime_flags() : boost::locale::ios_info
    • +
  • decode() +: boost::locale::utf::utf_traits< CharType, size > +
    • +
  • decode_valid() +: boost::locale::utf::utf_traits< CharType, size > +
  • difference() : boost::locale::date_time , boost::locale::abstract_calendar
  • display_flags() -: boost::locale::ios_info +: boost::locale::ios_info
  • do_compare() : boost::locale::collator< CharType >
  • do_hash() -: boost::locale::collator< CharType > +: boost::locale::collator< CharType >
  • do_transform() : boost::locale::collator< CharType >
  • domain() -: boost::locale::gnu_gettext::messages_info::domain -, boost::locale::message_format< CharType > +: boost::locale::message_format< CharType > +, boost::locale::gnu_gettext::messages_info::domain
  • domain_id() -: boost::locale::ios_info +: boost::locale::ios_info
    • diff --git a/doc/html/functions_func_0x65.html b/doc/html/functions_func_0x65.html index 63a79cc..ade552d 100644 --- a/doc/html/functions_func_0x65.html +++ b/doc/html/functions_func_0x65.html @@ -107,15 +107,17 @@
  • empty() : boost::locale::boundary::segment< IteratorType >
    • +
  • encode() +: boost::locale::utf::utf_traits< CharType, size > +
  • encoding() : boost::locale::info
  • end() -: boost::locale::boundary::segment< IteratorType > -, boost::locale::boundary::boundary_point_index< BaseIterator > +: boost::locale::boundary::boundary_point_index< BaseIterator > , boost::locale::boundary::segment_index< BaseIterator > , boost::locale::date_time_duration -, boost::locale::boundary::segment< IteratorType > +, boost::locale::boundary::segment< IteratorType >
    • diff --git a/doc/html/functions_func_0x69.html b/doc/html/functions_func_0x69.html index d38359b..d346231 100644 --- a/doc/html/functions_func_0x69.html +++ b/doc/html/functions_func_0x69.html @@ -119,11 +119,17 @@
  • is_in_daylight_saving_time() : boost::locale::date_time
    • +
  • is_lead() +: boost::locale::utf::utf_traits< CharType, size > +
  • is_thread_safe() : boost::locale::util::base_converter
    • +
  • is_trail() +: boost::locale::utf::utf_traits< CharType, size > +
  • iterator() -: boost::locale::boundary::boundary_point< IteratorType > +: boost::locale::boundary::boundary_point< IteratorType >
    • diff --git a/doc/html/functions_func_0x74.html b/doc/html/functions_func_0x74.html index 97ac167..e845507 100644 --- a/doc/html/functions_func_0x74.html +++ b/doc/html/functions_func_0x74.html @@ -116,8 +116,11 @@
  • to_unicode() : boost::locale::util::base_converter
    • +
  • trail_length() +: boost::locale::utf::utf_traits< CharType, size > +
  • transform() -: boost::locale::collator< CharType > +: boost::locale::collator< CharType >
    • diff --git a/doc/html/functions_func_0x77.html b/doc/html/functions_func_0x77.html index 6c48a0f..78c0fdd 100644 --- a/doc/html/functions_func_0x77.html +++ b/doc/html/functions_func_0x77.html @@ -104,9 +104,12 @@  

    - w -

    diff --git a/doc/html/functions_type.html b/doc/html/functions_type.html index f79d817..f0e689a 100644 --- a/doc/html/functions_type.html +++ b/doc/html/functions_type.html @@ -89,6 +89,7 @@ , boost::locale::message_format< CharType > , boost::locale::basic_message< CharType > , boost::locale::boundary::segment< IteratorType > +, boost::locale::utf::utf_traits< CharType, size > , boost::locale::basic_format< CharType >
  • const_iterator diff --git a/doc/html/functions_vars.html b/doc/html/functions_vars.html index fde27ea..558d312 100644 --- a/doc/html/functions_vars.html +++ b/doc/html/functions_vars.html @@ -108,6 +108,9 @@
  • locale_category : boost::locale::gnu_gettext::messages_info
    • +
  • max_width +: boost::locale::utf::utf_traits< CharType, size > +
  • name : boost::locale::gnu_gettext::messages_info::domain
    • diff --git a/doc/html/group__codepage.html b/doc/html/group__codepage.html index bbd708d..6fcc971 100644 --- a/doc/html/group__codepage.html +++ b/doc/html/group__codepage.html @@ -2,7 +2,7 @@ -Boost.Locale: Character conversion functions +Boost.Locale: Codepage -
    -
    -
    boost/locale/localization_backend.hpp [code]
    boost/locale/message.hpp [code]
    boost/locale/time_zone.hpp [code]
    boost/locale/utf.hpp [code]
    boost/locale/util.hpp [code]
    boost/locale/boundary/boundary_point.hpp [code]
    boost/locale/boundary/facets.hpp [code]
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    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::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

    -
    Note:
    throws 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::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

    -
    Note:
    throws 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::locale const &  loc,
    method_type  how = default_method 
    )
    -
    -
    -

    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
    - -
    -
    - -
    -
    -
    -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::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 (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 (std::string const &  text,
    std::locale const &  loc,
    method_type  how = default_method 
    )
    -
    -
    -

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

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

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

    - -
    -
    @@ -797,6 +152,36 @@ template<typename CharOut , typename CharIn >

    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 (std::basic_string< CharIn > const &  str,
    method_type  how = default_method 
    )
    +
    +
    +

    Convert a Unicode string str other Unicode encoding

    +
    diff --git a/doc/html/hierarchy.html b/doc/html/hierarchy.html index 410cd7e..f21ea65 100644 --- a/doc/html/hierarchy.html +++ b/doc/html/hierarchy.html @@ -110,6 +110,7 @@ This inheritance list is sorted roughly, but not completely, alphabetically:
    diff --git a/doc/html/modules.html b/doc/html/modules.html index 87e2228..021a6bf 100644 --- a/doc/html/modules.html +++ b/doc/html/modules.html @@ -67,11 +67,11 @@ Here is a list of all modules:
    diff --git a/doc/html/namespaceboost_1_1locale.html b/doc/html/namespaceboost_1_1locale.html index 9a595eb..e68bccb 100644 --- a/doc/html/namespaceboost_1_1locale.html +++ b/doc/html/namespaceboost_1_1locale.html @@ -98,11 +98,6 @@ Namespaces

     

    This namespae contains all operations required for boundary analysis of text.


    -namespace  conv - -

     

    Namespace that contains all functions related to character set conversion.

    -
    -

    namespace  flags

     

    This namespace holds additional formatting flags that can be set using ios_info.

    @@ -123,6 +118,11 @@ Namespaces

     

    namespace that holds functions for operating with global time zone


    +namespace  utf + +

     

    Namespace that holds basic operations on UTF encoded sequences.

    +
    +

    namespace  util

     

    This namespace provides various utility function useful for Boost.Locale backends implementations.

    diff --git a/doc/html/namespaceboost_1_1locale_1_1conv.html b/doc/html/namespaceboost_1_1locale_1_1conv.html deleted file mode 100644 index fc9a28d..0000000 --- a/doc/html/namespaceboost_1_1locale_1_1conv.html +++ /dev/null @@ -1,142 +0,0 @@ - - - - -Boost.Locale: boost::locale::conv Namespace Reference - - - - - - -
    -
    -
    - -

    - - - - Boost - C++ Libraries - -

    - -

    - - ...one of the most highly - regarded and expertly designed C++ library projects in the - world. - - — Herb Sutter and Andrei - Alexandrescu, C++ - Coding Standards -

    -
    -
    - -
    - - -
    -
    -Classes | -Enumerations | -Functions
    -
    -

    boost::locale::conv Namespace Reference

    -
    -
    - -

    Namespace that contains all functions related to character set conversion. -More...

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    -Classes

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

    -Enumerations

    enum  method_type { skip = 0, -stop = 1, -default_method = skip - }

    -Functions

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

    Detailed Description

    -

    Namespace that contains all functions related to character set conversion.

    -
    -
    -© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. -
    - - diff --git a/doc/html/namespaceboost_1_1locale_1_1utf.html b/doc/html/namespaceboost_1_1locale_1_1utf.html new file mode 100644 index 0000000..3bc0674 --- /dev/null +++ b/doc/html/namespaceboost_1_1locale_1_1utf.html @@ -0,0 +1,119 @@ + + + + +Boost.Locale: boost::locale::utf Namespace Reference + + + + + + +
    +
    +
    + +

    + + + + Boost + C++ Libraries + +

    + +

    + + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

    +
    +
    + +
    + + +
    +
    +Classes | +Typedefs | +Functions | +Variables
    +
    +

    boost::locale::utf Namespace Reference

    +
    +
    + +

    Namespace that holds basic operations on UTF encoded sequences. +More...

    + + + + + + + + + + + + + + + +

    +Classes

    struct  utf_traits
     UTF Traits class - functions to convert UTF sequences to and from Unicode code points. More...

    +Typedefs

    +typedef uint32_t code_point
     The integral type type that can hold a Unicode code point.

    +Functions

    +bool is_valid_codepoint (code_point v)
     the function checks if v is a valid code point

    +Variables

    +static const code_point illegal = 0xFFFFFFFFu
     Special constant that defines illegal code point.
    +static const code_point incomplete = 0xFFFFFFFEu
     Special constant that defines incomplete code point.
    +

    Detailed Description

    +

    Namespace that holds basic operations on UTF encoded sequences.

    +

    All functions defined in this namespace do not require linking with Boost.Locale library

    +
    +
    +© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
    + + diff --git a/doc/html/namespacemembers_0x62.html b/doc/html/namespacemembers_0x62.html index 1537999..f38995c 100644 --- a/doc/html/namespacemembers_0x62.html +++ b/doc/html/namespacemembers_0x62.html @@ -104,9 +104,6 @@ Here is a list of all documented namespace members with links to the namespaces they belong to:

    - b -

    diff --git a/doc/html/namespacemembers_0x73.html b/doc/html/namespacemembers_0x73.html index c824542..4ec0106 100644 --- a/doc/html/namespacemembers_0x73.html +++ b/doc/html/namespacemembers_0x73.html @@ -135,9 +135,6 @@ Here is a list of all documented namespace members with links to the namespaces
  • september() : boost::locale::period
    • -
  • skip -: boost::locale::conv -
  • spellout() : boost::locale::as
    • @@ -147,9 +144,6 @@ Here is a list of all documented namespace members with links to the namespaces
  • ssegment_index : boost::locale::boundary
    • -
  • stop -: boost::locale::conv -
  • strftime() : boost::locale::as
    • diff --git a/doc/html/namespacemembers_0x74.html b/doc/html/namespacemembers_0x74.html index 6e3f717..f4bcd91 100644 --- a/doc/html/namespacemembers_0x74.html +++ b/doc/html/namespacemembers_0x74.html @@ -138,10 +138,7 @@ Here is a list of all documented namespace members with links to the namespaces : boost::locale
  • to_upper() -: boost::locale -
    • -
  • to_utf() -: boost::locale::conv +: boost::locale
  • translate() : boost::locale diff --git a/doc/html/namespacemembers_0x75.html b/doc/html/namespacemembers_0x75.html index 70ba9f8..0dfb060 100644 --- a/doc/html/namespacemembers_0x75.html +++ b/doc/html/namespacemembers_0x75.html @@ -164,9 +164,6 @@ Here is a list of all documented namespace members with links to the namespaces
  • u32ssegment_index : boost::locale::boundary
    • -
  • utf_to_utf() -: boost::locale::conv -
    • diff --git a/doc/html/namespacemembers_enum.html b/doc/html/namespacemembers_enum.html index ed36513..f9af040 100644 --- a/doc/html/namespacemembers_enum.html +++ b/doc/html/namespacemembers_enum.html @@ -82,9 +82,6 @@
  • display_flags_type : boost::locale::flags
    • -
  • method_type -: boost::locale::conv -
  • norm_type : boost::locale
    • diff --git a/doc/html/namespacemembers_eval.html b/doc/html/namespacemembers_eval.html index c084699..72ddca7 100644 --- a/doc/html/namespacemembers_eval.html +++ b/doc/html/namespacemembers_eval.html @@ -73,43 +73,15 @@
  • Enumerator
    • -
    - -
    -  - -

    - a -

    @@ -102,9 +101,6 @@  

    - b -

      -
    • between() -: boost::locale::conv -
    • boundary_rule() : boost::locale::boundary
      • diff --git a/doc/html/namespacemembers_func_0x63.html b/doc/html/namespacemembers_func_0x63.html index 2345ff0..09febcd 100644 --- a/doc/html/namespacemembers_func_0x63.html +++ b/doc/html/namespacemembers_func_0x63.html @@ -92,7 +92,6 @@
    • p
    • s
    • t
      • -
    • u
    • w
    • y
    diff --git a/doc/html/namespacemembers_func_0x64.html b/doc/html/namespacemembers_func_0x64.html index db2cade..2a5e095 100644 --- a/doc/html/namespacemembers_func_0x64.html +++ b/doc/html/namespacemembers_func_0x64.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x65.html b/doc/html/namespacemembers_func_0x65.html index 8873c8a..b25baea 100644 --- a/doc/html/namespacemembers_func_0x65.html +++ b/doc/html/namespacemembers_func_0x65.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x66.html b/doc/html/namespacemembers_func_0x66.html index a3f463e..7ec74aa 100644 --- a/doc/html/namespacemembers_func_0x66.html +++ b/doc/html/namespacemembers_func_0x66.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • @@ -109,14 +108,11 @@ : boost::locale::period
  • fold_case() -: boost::locale +: boost::locale
  • friday() : boost::locale::period
    • -
  • from_utf() -: boost::locale::conv -
  • ftime() : boost::locale::as
    • diff --git a/doc/html/namespacemembers_func_0x67.html b/doc/html/namespacemembers_func_0x67.html index 6dc0258..848a649 100644 --- a/doc/html/namespacemembers_func_0x67.html +++ b/doc/html/namespacemembers_func_0x67.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x68.html b/doc/html/namespacemembers_func_0x68.html index 45e4e57..1f41b58 100644 --- a/doc/html/namespacemembers_func_0x68.html +++ b/doc/html/namespacemembers_func_0x68.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x69.html b/doc/html/namespacemembers_func_0x69.html index 32cb9fa..1083930 100644 --- a/doc/html/namespacemembers_func_0x69.html +++ b/doc/html/namespacemembers_func_0x69.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • @@ -105,6 +104,9 @@
  • invalid() : boost::locale::period
    • +
  • is_valid_codepoint() +: boost::locale::utf +
    • diff --git a/doc/html/namespacemembers_func_0x6a.html b/doc/html/namespacemembers_func_0x6a.html index 308d434..d0b54bc 100644 --- a/doc/html/namespacemembers_func_0x6a.html +++ b/doc/html/namespacemembers_func_0x6a.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x6c.html b/doc/html/namespacemembers_func_0x6c.html index 9f0edb5..e1e51c2 100644 --- a/doc/html/namespacemembers_func_0x6c.html +++ b/doc/html/namespacemembers_func_0x6c.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x6d.html b/doc/html/namespacemembers_func_0x6d.html index 3a6b2d7..8c2ac3b 100644 --- a/doc/html/namespacemembers_func_0x6d.html +++ b/doc/html/namespacemembers_func_0x6d.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x6e.html b/doc/html/namespacemembers_func_0x6e.html index fe7e3b9..b68ea3c 100644 --- a/doc/html/namespacemembers_func_0x6e.html +++ b/doc/html/namespacemembers_func_0x6e.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x6f.html b/doc/html/namespacemembers_func_0x6f.html index e11cba3..43f79ae 100644 --- a/doc/html/namespacemembers_func_0x6f.html +++ b/doc/html/namespacemembers_func_0x6f.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x70.html b/doc/html/namespacemembers_func_0x70.html index 9c5692e..a9dbf32 100644 --- a/doc/html/namespacemembers_func_0x70.html +++ b/doc/html/namespacemembers_func_0x70.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x73.html b/doc/html/namespacemembers_func_0x73.html index bb41ced..2070cac 100644 --- a/doc/html/namespacemembers_func_0x73.html +++ b/doc/html/namespacemembers_func_0x73.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x74.html b/doc/html/namespacemembers_func_0x74.html index 99561e9..826ad56 100644 --- a/doc/html/namespacemembers_func_0x74.html +++ b/doc/html/namespacemembers_func_0x74.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • @@ -135,11 +134,8 @@
  • to_upper() : boost::locale
    • -
  • to_utf() -: boost::locale::conv -
  • translate() -: boost::locale +: boost::locale
  • tuesday() : boost::locale::period diff --git a/doc/html/namespacemembers_func_0x75.html b/doc/html/namespacemembers_func_0x75.html deleted file mode 100644 index abf0966..0000000 --- a/doc/html/namespacemembers_func_0x75.html +++ /dev/null @@ -1,114 +0,0 @@ - - - - -Boost.Locale: Class Members - - - - - - -
    -
    -
    - -

    - - - - Boost - C++ Libraries - -

    - -

    - - ...one of the most highly - regarded and expertly designed C++ library projects in the - world. - - — Herb Sutter and Andrei - Alexandrescu, C++ - Coding Standards -

    -
    -
    - -
    - - -
    -  - -

    - u -

    -
    -
    -© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. -
    - - diff --git a/doc/html/namespacemembers_func_0x77.html b/doc/html/namespacemembers_func_0x77.html index 79ae362..19d8086 100644 --- a/doc/html/namespacemembers_func_0x77.html +++ b/doc/html/namespacemembers_func_0x77.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_func_0x79.html b/doc/html/namespacemembers_func_0x79.html index afd7fab..8ba1c0e 100644 --- a/doc/html/namespacemembers_func_0x79.html +++ b/doc/html/namespacemembers_func_0x79.html @@ -92,7 +92,6 @@
  • p
  • s
  • t
    • -
  • u
  • w
  • y
    • diff --git a/doc/html/namespacemembers_type.html b/doc/html/namespacemembers_type.html index edef5b6..33ef990 100644 --- a/doc/html/namespacemembers_type.html +++ b/doc/html/namespacemembers_type.html @@ -100,6 +100,9 @@
  • character_facet_type : boost::locale
    • +
  • code_point +: boost::locale::utf +
  • csegment : boost::locale::boundary
    • diff --git a/doc/html/namespacemembers_vars.html b/doc/html/namespacemembers_vars.html index c44b115..0e385a7 100644 --- a/doc/html/namespacemembers_vars.html +++ b/doc/html/namespacemembers_vars.html @@ -154,6 +154,12 @@

    - i -

      +
    • illegal +: boost::locale::utf +
      • +
    • incomplete +: boost::locale::utf +
    • information_facet : boost::locale
      • diff --git a/doc/html/namespaces.html b/doc/html/namespaces.html index 683d699..e873a08 100644 --- a/doc/html/namespaces.html +++ b/doc/html/namespaces.html @@ -73,12 +73,12 @@ Here is a list of all documented namespaces with brief descriptions: - +
      boost::localeThis is the main namespace that encloses all localization classes
      boost::locale::asThis namespace includes all manipulators that can be used on IO streams
      boost::locale::boundaryThis namespae contains all operations required for boundary analysis of text
      boost::locale::convNamespace that contains all functions related to character set conversion
      boost::locale::flagsThis namespace holds additional formatting flags that can be set using ios_info
      boost::locale::gnu_gettextThis namespace holds classes that provide GNU Gettext message catalogs support
      boost::locale::periodNamespace that contains various types for manipulation with dates
      boost::locale::period::marksThis namespace holds a enum of various period types like era, year, month, etc.
      boost::locale::time_zoneNamespace that holds functions for operating with global time zone
      boost::locale::utfNamespace that holds basic operations on UTF encoded sequences
      boost::locale::utilThis namespace provides various utility function useful for Boost.Locale backends implementations
      diff --git a/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits-members.html b/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits-members.html new file mode 100644 index 0000000..681b04c --- /dev/null +++ b/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits-members.html @@ -0,0 +1,88 @@ + + + + +Boost.Locale: Member List + + + + + + +
      +
      +
      + +

      + + + + Boost + C++ Libraries + +

      + +

      + + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

      +
      +
      + +
      + + +
      +
      +

      boost::locale::utf::utf_traits< CharType, size > Member List

      +
      +
      +This is the complete list of members for boost::locale::utf::utf_traits< CharType, size >, including all inherited members. + + + + + + + + + +
      char_type typedefboost::locale::utf::utf_traits< CharType, size >
      decode(Iterator &p, Iterator e)boost::locale::utf::utf_traits< CharType, size > [static]
      decode_valid(Iterator &p)boost::locale::utf::utf_traits< CharType, size > [static]
      encode(code_point value, Iterator out)boost::locale::utf::utf_traits< CharType, size > [static]
      is_lead(char_type c)boost::locale::utf::utf_traits< CharType, size > [static]
      is_trail(char_type c)boost::locale::utf::utf_traits< CharType, size > [static]
      max_widthboost::locale::utf::utf_traits< CharType, size > [static]
      trail_length(char_type c)boost::locale::utf::utf_traits< CharType, size > [static]
      width(code_point value)boost::locale::utf::utf_traits< CharType, size > [static]
      +
      +© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
      + + diff --git a/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits.html b/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits.html new file mode 100644 index 0000000..0401480 --- /dev/null +++ b/doc/html/structboost_1_1locale_1_1utf_1_1utf__traits.html @@ -0,0 +1,357 @@ + + + + +Boost.Locale: boost::locale::utf::utf_traits< CharType, size > Struct Template Reference + + + + + + +
      +
      +
      + +

      + + + + Boost + C++ Libraries + +

      + +

      + + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

      +
      +
      + +
      + + +
      +
      +Public Types | +Static Public Member Functions | +Static Public Attributes
      +
      +

      boost::locale::utf::utf_traits< CharType, size > Struct Template Reference

      +
      +
      + +

      UTF Traits class - functions to convert UTF sequences to and from Unicode code points. +More...

      + +

      #include <boost/locale/utf.hpp>

      + +

      List of all members.

      + + + + + + + + + + + + + + + + +

      +Public Types

      typedef CharType char_type

      +Static Public Member Functions

      template<typename Iterator >
      static code_point decode (Iterator &p, Iterator e)
      static int width (code_point value)
      static int trail_length (char_type c)
      static bool is_trail (char_type c)
      static bool is_lead (char_type c)
      template<typename Iterator >
      static Iterator encode (code_point value, Iterator out)
      template<typename Iterator >
      static code_point decode_valid (Iterator &p)

      +Static Public Attributes

      static const int max_width
      +

      Detailed Description

      +

      template<typename CharType, int size = sizeof(CharType)>
      + struct boost::locale::utf::utf_traits< CharType, size >

      + +

      UTF Traits class - functions to convert UTF sequences to and from Unicode code points.

      +

      Member Typedef Documentation

      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + +
      typedef CharType boost::locale::utf::utf_traits< CharType, size >::char_type
      +
      +
      +

      The type of the character

      + +
      +
      +

      Member Function Documentation

      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      +
      +template<typename Iterator >
      + + + + + + + + + + + + + + + + + + +
      static code_point boost::locale::utf::utf_traits< CharType, size >::decode (Iterator &  p,
      Iterator  e 
      ) [static]
      +
      +
      +

      Read one code point from the range [p,e) and return it.

      +
        +
      • If the sequence that was read is incomplete sequence returns incomplete,
        • +
      • If illegal sequence detected returns illegal
        • +
      +

      Requirements

      +
        +
      • Iterator is valid input iterator
        • +
      +

      Postconditions

      +
        +
      • p points to the last consumed character
        • +
      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      +
      +template<typename Iterator >
      + + + + + + + + + +
      static code_point boost::locale::utf::utf_traits< CharType, size >::decode_valid (Iterator &  p )  [static]
      +
      +
      +

      Decodes valid UTF sequence that is pointed by p into code point.

      +

      If the sequence is invalid or points to end the behavior is undefined

      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      +
      +template<typename Iterator >
      + + + + + + + + + + + + + + + + + + +
      static Iterator boost::locale::utf::utf_traits< CharType, size >::encode (code_point  value,
      Iterator  out 
      ) [static]
      +
      +
      +

      Convert valid Unicode code point value to the UTF sequence.

      +

      Requirements:

      +
        +
      • value is valid code point
        • +
      • out is an output iterator should be able to accept at least width(value) units
        • +
      +

      Returns the iterator past the last written code unit.

      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + + + + + + +
      static bool boost::locale::utf::utf_traits< CharType, size >::is_lead (char_type  c )  [static]
      +
      +
      +

      Returns true if c is lead code unit, always true of UTF-32

      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + + + + + + +
      static bool boost::locale::utf::utf_traits< CharType, size >::is_trail (char_type  c )  [static]
      +
      +
      +

      Returns true if c is trail code unit, always false for UTF-32

      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + + + + + + +
      static int boost::locale::utf::utf_traits< CharType, size >::trail_length (char_type  c )  [static]
      +
      +
      +

      Get the size of the trail part of variable length encoded sequence.

      +

      Returns -1 if C is not valid lead character

      + +
      +
      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + + + + + + +
      static int boost::locale::utf::utf_traits< CharType, size >::width (code_point  value )  [static]
      +
      +
      +

      The width of specific code point in the code units.

      +

      Requirement: value is a valid Unicode code point Returns value in range [1..max_width]

      + +
      +
      +

      Member Data Documentation

      + +
      +
      +
      +template<typename CharType, int size = sizeof(CharType)>
      + + + + +
      const int boost::locale::utf::utf_traits< CharType, size >::max_width [static]
      +
      +
      +

      Maximal width of valid sequence in the code units:

      +
        +
      • UTF-8 - 4
        • +
      • UTF-16 - 2
        • +
      • UTF-32 - 1
        • +
      + +
      +
      +
      The documentation for this struct was generated from the following file: +
      +
      +© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
      + + diff --git a/doc/html/tree.html b/doc/html/tree.html index 880def1..a886d33 100644 --- a/doc/html/tree.html +++ b/doc/html/tree.html @@ -102,11 +102,11 @@

      |o*Collation

      |o*Text Conversions

      |o*Date, Time, Timezone and Calendar manipulations

      -

      |o*Character conversion functions

      |o*Format

      |o*I/O Stream manipulators

      |o*Message Formatting (translation)

      -

      |\*Boundary Analysis

      +

      |o*Boundary Analysis

      +

      |\*Codepage

      o+Class List

      o+Class Hierarchy

      o*Class Members

      o+Namespace List

      @@ -194,12 +196,12 @@

      |o*boost::locale

      |o*boost::locale::as

      |o*boost::locale::boundary

      -

      |o*boost::locale::conv

      |o*boost::locale::flags

      |o*boost::locale::gnu_gettext

      |o*boost::locale::period

      |o*boost::locale::period::marks

      |o*boost::locale::time_zone

      +

      |o*boost::locale::utf

      |\*boost::locale::util

      o*Namespace Members

      @@ -211,7 +213,10 @@

      |o*boost/locale/conversion.hpp

      |o*boost/locale/date_time.hpp

      |o*boost/locale/date_time_facet.hpp

      +

      |o*boost/locale/definitions.hpp

      |o*boost/locale/encoding.hpp

      +

      |o*boost/locale/encoding_errors.hpp

      +

      |o*boost/locale/encoding_utf.hpp

      |o*boost/locale/format.hpp

      |o*boost/locale/formatting.hpp

      |o*boost/locale/generator.hpp

      @@ -221,6 +226,7 @@

      |o*boost/locale/localization_backend.hpp

      |o*boost/locale/message.hpp

      |o*boost/locale/time_zone.hpp

      +

      |o*boost/locale/utf.hpp

      |o*boost/locale/util.hpp

      |o*boost/locale/boundary/boundary_point.hpp

      |o*boost/locale/boundary/facets.hpp

      diff --git a/doc/html/utf_8hpp_source.html b/doc/html/utf_8hpp_source.html new file mode 100644 index 0000000..9c70de4 --- /dev/null +++ b/doc/html/utf_8hpp_source.html @@ -0,0 +1,450 @@ + + + + +Boost.Locale: boost/locale/utf.hpp Source File + + + + + + +
      +
      +
      + +

      + + + + Boost + C++ Libraries + +

      + +

      + + ...one of the most highly + regarded and expertly designed C++ library projects in the + world. + + — Herb Sutter and Andrei + Alexandrescu, C++ + Coding Standards +

      +
      +
      + +
      + + +
      +© Copyright 2009-2011 Artyom Beilis, Distributed under the Boost Software License, Version 1.0. +
      + + diff --git a/doc/html/util_8hpp_source.html b/doc/html/util_8hpp_source.html index 1d451bd..29753dd 100644 --- a/doc/html/util_8hpp_source.html +++ b/doc/html/util_8hpp_source.html @@ -79,81 +79,82 @@ 00010 #include <locale> 00011 #include <typeinfo> 00012 #include <boost/cstdint.hpp> -00013 #include <boost/locale/generator.hpp> -00014 #include <boost/assert.hpp> -00015 -00016 #include <vector> -00017 namespace boost { -00018 namespace locale { -00023 namespace util { -00024 -00038 BOOST_LOCALE_DECL -00039 std::string get_system_locale(bool use_utf8_on_windows = false); -00040 -00058 BOOST_LOCALE_DECL -00059 std::locale create_info(std::locale const &in,std::string const &name); -00060 +00013 #include <boost/locale/utf.hpp> +00014 #include <boost/locale/generator.hpp> +00015 #include <boost/assert.hpp> +00016 +00017 #include <vector> +00018 namespace boost { +00019 namespace locale { +00024 namespace util { +00025 +00039 BOOST_LOCALE_DECL +00040 std::string get_system_locale(bool use_utf8_on_windows = false); +00041 +00059 BOOST_LOCALE_DECL +00060 std::locale create_info(std::locale const &in,std::string const &name); 00061 -00076 class base_converter { -00077 public: -00078 -00084 static const uint32_t illegal=0xFFFFFFFF; -00085 -00090 static const uint32_t incomplete=0xFFFFFFFE; -00091 -00092 virtual ~base_converter() -00093 { -00094 } -00099 virtual int max_len() const -00100 { -00101 return 1; -00102 } -00112 virtual bool is_thread_safe() const -00113 { -00114 return false; -00115 } -00119 virtual base_converter *clone() const -00120 { -00121 BOOST_ASSERT(typeid(*this)==typeid(base_converter)); -00122 return new base_converter(); -00123 } -00124 -00140 virtual uint32_t to_unicode(char const *&begin,char const *end) -00141 { -00142 if(begin == end) -00143 return incomplete; -00144 unsigned char cp = *begin; -00145 if(cp <= 0x7F) { -00146 begin++; -00147 return cp; -00148 } -00149 return illegal; -00150 } -00162 -00163 virtual uint32_t from_unicode(uint32_t u,char *begin,char const *end) -00164 { -00165 if(begin==end) -00166 return incomplete; -00167 if(u >= 0x80) -00168 return illegal; -00169 *begin = static_cast<char>(u); -00170 return 1; -00171 } -00172 }; -00173 -00178 BOOST_LOCALE_DECL std::auto_ptr<base_converter> create_utf8_converter(); -00186 BOOST_LOCALE_DECL std::auto_ptr<base_converter> create_simple_converter(std::string const &encoding); -00187 +00062 +00077 class base_converter { +00078 public: +00079 +00085 static const uint32_t illegal=utf::illegal; +00086 +00091 static const uint32_t incomplete=utf::incomplete; +00092 +00093 virtual ~base_converter() +00094 { +00095 } +00100 virtual int max_len() const +00101 { +00102 return 1; +00103 } +00113 virtual bool is_thread_safe() const +00114 { +00115 return false; +00116 } +00120 virtual base_converter *clone() const +00121 { +00122 BOOST_ASSERT(typeid(*this)==typeid(base_converter)); +00123 return new base_converter(); +00124 } +00125 +00141 virtual uint32_t to_unicode(char const *&begin,char const *end) +00142 { +00143 if(begin == end) +00144 return incomplete; +00145 unsigned char cp = *begin; +00146 if(cp <= 0x7F) { +00147 begin++; +00148 return cp; +00149 } +00150 return illegal; +00151 } +00163 +00164 virtual uint32_t from_unicode(uint32_t u,char *begin,char const *end) +00165 { +00166 if(begin==end) +00167 return incomplete; +00168 if(u >= 0x80) +00169 return illegal; +00170 *begin = static_cast<char>(u); +00171 return 1; +00172 } +00173 }; +00174 +00179 BOOST_LOCALE_DECL std::auto_ptr<base_converter> create_utf8_converter(); +00187 BOOST_LOCALE_DECL std::auto_ptr<base_converter> create_simple_converter(std::string const &encoding); 00188 -00200 BOOST_LOCALE_DECL -00201 std::locale create_codecvt(std::locale const &in,std::auto_ptr<base_converter> cvt,character_facet_type type); -00202 -00203 } // util -00204 } // locale -00205 } // boost -00206 -00207 #endif -00208 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4 +00189 +00201 BOOST_LOCALE_DECL +00202 std::locale create_codecvt(std::locale const &in,std::auto_ptr<base_converter> cvt,character_facet_type type); +00203 +00204 } // util +00205 } // locale +00206 } // boost +00207 +00208 #endif +00209 // vim: tabstop=4 expandtab shiftwidth=4 softtabstop=4