19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// This file is part of the ustl library, an STL implementation. 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// Copyright (C) 2005 by Mike Sharov <msharov@users.sourceforge.net> 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// This file is free software, distributed under the MIT License. 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// utf8.h 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// This file contains stream iterators that read and write UTF-8 encoded 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// characters. The encoding is defined as follows: 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-00000000 - U-0000007F: 0xxxxxxx 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-00000080 - U-000007FF: 110xxxxx 10xxxxxx 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-00000800 - U-0000FFFF: 1110xxxx 10xxxxxx 10xxxxxx 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-00010000 - U-001FFFFF: 11110xxx 10xxxxxx 10xxxxxx 10xxxxxx 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-00200000 - U-03FFFFFF: 111110xx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-04000000 - U-7FFFFFFF: 1111110x 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// U-80000000 - U-FFFFFFFF: 11111110 100000xx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 10xxxxxx 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// The last range in not in the UTF-8 standard because Unicode forbids 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// characters of those values. However, since ustl::string uses this code 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// to write its length, the support is here. The reason it was put here 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// in the first place, is that extra code would have been necessary to 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// flag that range as invalid. 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project// 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#ifndef UTF8_H_3D7AEEEB3A88928D4D280B785F78B6F4 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#define UTF8_H_3D7AEEEB3A88928D4D280B785F78B6F4 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#include "uiterator.h" 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectnamespace ustl { 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttypedef uint8_t utf8subchar_t; ///< Type for the encoding subcharacters. 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns the number of bytes required to UTF-8 encode \p v. 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinline size_t Utf8Bytes (wchar_t v) 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project static const uint32_t c_Bounds[] = { 0x0000007F, 0x000007FF, 0x0000FFFF, 0x001FFFFF, 0x03FFFFFF, 0x7FFFFFFF, 0xFFFFFFFF, }; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t bi = 0; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (c_Bounds[bi++] < uint32_t(v)); 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (bi); 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns the number of bytes in a UTF-8 sequence that starts with \p c. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinline size_t Utf8SequenceBytes (wchar_t c) // a wchar_t to keep c in a full register 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Count the leading bits. Header bits are 1 * nBytes followed by a 0. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 0 - single byte character. Take 7 bits (0xFF >> 1) 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 1 - error, in the middle of the character. Take 6 bits (0xFF >> 2) 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // so you will keep reading invalid entries until you hit the next character. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // >2 - multibyte character. Take remaining bits, and get the next bytes. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // All errors are ignored, since the user can not correct them. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project wchar_t mask = 0x80; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t nBytes = 0; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (; c & mask; ++nBytes) 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mask >>= 1; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (nBytes ? nBytes : 1); // A sequence is always at least 1 byte. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \class utf8in_iterator utf8.h ustl.h 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \ingroup IteratorAdaptors 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \brief An iterator adaptor to character containers for reading UTF-8 encoded text. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// For example, you can copy from ustl::string to ustl::vector<wchar_t> with 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// copy (utf8in (str.begin()), utf8in (str.end()), back_inserter(wvect)); 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// There is no error handling; if the reading frame slips you'll get extra 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// characters, one for every misaligned byte. Although it is possible to skip 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// to the start of the next character, that would result in omitting the 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// misformatted character and the one after it, making it very difficult to 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// detect by the user. It is better to write some strange characters and let 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// the user know his file is corrupted. Another problem is overflow on bad 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// encodings (like a 0xFF on the end of a string). This is checked through 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// the end-of-string nul character, which will always be there as long as 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// you are using the string class. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator, typename WChar = wchar_t> 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass utf8in_iterator { 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::value_type value_type; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::difference_type difference_type; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::pointer pointer; 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::reference reference; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project explicit utf8in_iterator (const Iterator& is) : m_i (is), m_v (0) { Read(); } 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project utf8in_iterator (const utf8in_iterator& i) : m_i (i.m_i), m_v (i.m_v) {} 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline const utf8in_iterator& operator= (const utf8in_iterator& i) { m_i = i.m_i; m_v = i.m_v; return (*this); } 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline Iterator base (void) const { return (m_i - (Utf8Bytes(m_v) - 1)); } 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /// Reads and returns the next value. 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline WChar operator* (void) const { return (m_v); } 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8in_iterator& operator++ (void) { ++m_i; Read(); return (*this); } 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8in_iterator operator++ (int) { utf8in_iterator old (*this); operator++(); return (old); } 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8in_iterator& operator+= (uoff_t n) { while (n--) operator++(); return (*this); } 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8in_iterator operator+ (uoff_t n) { utf8in_iterator v (*this); return (v += n); } 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline bool operator== (const utf8in_iterator& i) const { return (m_i == i.m_i); } 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline bool operator< (const utf8in_iterator& i) const { return (m_i < i.m_i); } 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project difference_type operator- (const utf8in_iterator& i) const; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprivate: 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void Read (void); 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprivate: 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Iterator m_i; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WChar m_v; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Steps to the next character and updates current returnable value. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator, typename WChar> 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectvoid utf8in_iterator<Iterator,WChar>::Read (void) 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const utf8subchar_t c = *m_i; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project size_t nBytes = Utf8SequenceBytes (c); 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m_v = c & (0xFF >> nBytes); // First byte contains bits after the header. 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (--nBytes && *++m_i) // Each subsequent byte has 6 bits. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project m_v = (m_v << 6) | (*m_i & 0x3F); 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns the distance in characters (as opposed to the distance in bytes). 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator, typename WChar> 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttypename utf8in_iterator<Iterator,WChar>::difference_type 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectutf8in_iterator<Iterator,WChar>::operator- (const utf8in_iterator<Iterator,WChar>& last) const 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project difference_type dist = 0; 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project for (Iterator first (last.m_i); first < m_i; ++dist) 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project first = advance (first, Utf8SequenceBytes (*first)); 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (dist); 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \class utf8out_iterator utf8.h ustl.h 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \ingroup IteratorAdaptors 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// \brief An iterator adaptor to character containers for writing UTF-8 encoded text. 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator, typename WChar = wchar_t> 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectclass utf8out_iterator { 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::value_type value_type; 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::difference_type difference_type; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::pointer pointer; 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project typedef typename iterator_traits<Iterator>::reference reference; 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic: 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project explicit utf8out_iterator (const Iterator& os) : m_i (os) {} 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project utf8out_iterator (const utf8out_iterator& i) : m_i (i.m_i) {} 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline const Iterator& base (void) const { return (m_i); } 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /// Writes \p v into the stream. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project utf8out_iterator& operator= (WChar v); 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8out_iterator& operator* (void) { return (*this); } 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8out_iterator& operator++ (void) { return (*this); } 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline utf8out_iterator operator++ (int) { return (*this); } 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline bool operator== (const utf8out_iterator& i) const { return (m_i == i.m_i); } 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inline bool operator< (const utf8out_iterator& i) const { return (m_i < i.m_i); } 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectprivate: 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Iterator m_i; 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project}; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Writes \p v into the stream. 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator, typename WChar> 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectutf8out_iterator<Iterator,WChar>& utf8out_iterator<Iterator,WChar>::operator= (WChar v) 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project const size_t nBytes = Utf8Bytes (v); 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (nBytes > 1) { 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Write the bits 6 bits at a time, except for the first one, 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // which may be less than 6 bits. 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project register wchar_t shift = nBytes * 6; 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *m_i++ = ((v >> (shift -= 6)) & 0x3F) | (0xFF << (8 - nBytes)); 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project while (shift) 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *m_i++ = ((v >> (shift -= 6)) & 0x3F) | 0x80; 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else // If only one byte, there is no header. 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project *m_i++ = v; 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (*this); 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns a UTF-8 adaptor writing to \p i. Useful in conjuction with back_insert_iterator. 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator> 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinline utf8out_iterator<Iterator> utf8out (Iterator i) 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (utf8out_iterator<Iterator> (i)); 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/// Returns a UTF-8 adaptor reading from \p i. 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projecttemplate <typename Iterator> 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectinline utf8in_iterator<Iterator> utf8in (Iterator i) 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return (utf8in_iterator<Iterator> (i)); 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project//---------------------------------------------------------------------- 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} // namespace ustl 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project#endif 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 201