| OLD | NEW |
| 1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 #ifndef BASE_I18N_ICU_STRING_CONVERSIONS_H_ | 5 #ifndef BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
| 6 #define BASE_I18N_ICU_STRING_CONVERSIONS_H_ | 6 #define BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
| 7 #pragma once | 7 #pragma once |
| 8 | 8 |
| 9 #include <string> | 9 #include <string> |
| 10 | 10 |
| 11 #include "base/i18n/base_i18n_export.h" |
| 11 #include "base/string16.h" | 12 #include "base/string16.h" |
| 12 | 13 |
| 13 namespace base { | 14 namespace base { |
| 14 | 15 |
| 15 // Defines the error handling modes of UTF16ToCodepage, CodepageToUTF16, | 16 // Defines the error handling modes of UTF16ToCodepage, CodepageToUTF16, |
| 16 // WideToCodepage and CodepageToWide. | 17 // WideToCodepage and CodepageToWide. |
| 17 class OnStringConversionError { | 18 class OnStringConversionError { |
| 18 public: | 19 public: |
| 19 enum Type { | 20 enum Type { |
| 20 // The function will return failure. The output buffer will be empty. | 21 // The function will return failure. The output buffer will be empty. |
| 21 FAIL, | 22 FAIL, |
| 22 | 23 |
| 23 // The offending characters are skipped and the conversion will proceed as | 24 // The offending characters are skipped and the conversion will proceed as |
| 24 // if they did not exist. | 25 // if they did not exist. |
| 25 SKIP, | 26 SKIP, |
| 26 | 27 |
| 27 // When converting to Unicode, the offending byte sequences are substituted | 28 // When converting to Unicode, the offending byte sequences are substituted |
| 28 // by Unicode replacement character (U+FFFD). When converting from Unicode, | 29 // by Unicode replacement character (U+FFFD). When converting from Unicode, |
| 29 // this is the same as SKIP. | 30 // this is the same as SKIP. |
| 30 SUBSTITUTE, | 31 SUBSTITUTE, |
| 31 }; | 32 }; |
| 32 | 33 |
| 33 private: | 34 private: |
| 34 OnStringConversionError(); | 35 OnStringConversionError(); |
| 35 }; | 36 }; |
| 36 | 37 |
| 37 // Names of codepages (charsets) understood by icu. | 38 // Names of codepages (charsets) understood by icu. |
| 38 extern const char kCodepageLatin1[]; // a.k.a. ISO 8859-1 | 39 BASE_I18N_EXPORT extern const char kCodepageLatin1[]; // a.k.a. ISO 8859-1 |
| 39 extern const char kCodepageUTF8[]; | 40 BASE_I18N_EXPORT extern const char kCodepageUTF8[]; |
| 40 extern const char kCodepageUTF16BE[]; | 41 BASE_I18N_EXPORT extern const char kCodepageUTF16BE[]; |
| 41 extern const char kCodepageUTF16LE[]; | 42 BASE_I18N_EXPORT extern const char kCodepageUTF16LE[]; |
| 42 | 43 |
| 43 // Converts between UTF-16 strings and the encoding specified. If the | 44 // Converts between UTF-16 strings and the encoding specified. If the |
| 44 // encoding doesn't exist or the encoding fails (when on_error is FAIL), | 45 // encoding doesn't exist or the encoding fails (when on_error is FAIL), |
| 45 // returns false. | 46 // returns false. |
| 46 bool UTF16ToCodepage(const string16& utf16, | 47 BASE_I18N_EXPORT bool UTF16ToCodepage(const string16& utf16, |
| 47 const char* codepage_name, | 48 const char* codepage_name, |
| 48 OnStringConversionError::Type on_error, | 49 OnStringConversionError::Type on_error, |
| 49 std::string* encoded); | 50 std::string* encoded); |
| 50 bool CodepageToUTF16(const std::string& encoded, | 51 BASE_I18N_EXPORT bool CodepageToUTF16(const std::string& encoded, |
| 51 const char* codepage_name, | 52 const char* codepage_name, |
| 52 OnStringConversionError::Type on_error, | 53 OnStringConversionError::Type on_error, |
| 53 string16* utf16); | 54 string16* utf16); |
| 54 | 55 |
| 55 // Converts between wide strings and the encoding specified. If the | 56 // Converts between wide strings and the encoding specified. If the |
| 56 // encoding doesn't exist or the encoding fails (when on_error is FAIL), | 57 // encoding doesn't exist or the encoding fails (when on_error is FAIL), |
| 57 // returns false. | 58 // returns false. |
| 58 bool WideToCodepage(const std::wstring& wide, | 59 BASE_I18N_EXPORT bool WideToCodepage(const std::wstring& wide, |
| 59 const char* codepage_name, | 60 const char* codepage_name, |
| 60 OnStringConversionError::Type on_error, | 61 OnStringConversionError::Type on_error, |
| 61 std::string* encoded); | 62 std::string* encoded); |
| 62 bool CodepageToWide(const std::string& encoded, | 63 BASE_I18N_EXPORT bool CodepageToWide(const std::string& encoded, |
| 63 const char* codepage_name, | 64 const char* codepage_name, |
| 64 OnStringConversionError::Type on_error, | 65 OnStringConversionError::Type on_error, |
| 65 std::wstring* wide); | 66 std::wstring* wide); |
| 66 | 67 |
| 67 // Converts from any codepage to UTF-8 and ensures the resulting UTF-8 is | 68 // Converts from any codepage to UTF-8 and ensures the resulting UTF-8 is |
| 68 // normalized. | 69 // normalized. |
| 69 bool ConvertToUtf8AndNormalize(const std::string& text, | 70 BASE_I18N_EXPORT bool ConvertToUtf8AndNormalize(const std::string& text, |
| 70 const std::string& charset, | 71 const std::string& charset, |
| 71 std::string* result); | 72 std::string* result); |
| 72 | 73 |
| 73 } // namespace base | 74 } // namespace base |
| 74 | 75 |
| 75 #endif // BASE_I18N_ICU_STRING_CONVERSIONS_H_ | 76 #endif // BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
| OLD | NEW |