OLD | NEW |
1 // Copyright (c) 2009 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2009 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_STRING_CONVERSIONS_H_ | 5 #ifndef BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
6 #define BASE_I18N_STRING_CONVERSIONS_H_ | 6 #define BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/string16.h" | 10 #include "base/string16.h" |
11 #include "base/string_piece.h" | 11 #include "base/string_piece.h" |
12 | 12 |
13 // These convert between UTF-8, -16, and -32 strings. They are potentially slow, | |
14 // so avoid unnecessary conversions. The low-level versions return a boolean | |
15 // indicating whether the conversion was 100% valid. In this case, it will still | |
16 // do the best it can and put the result in the output buffer. The versions that | |
17 // return strings ignore this error and just return the best conversion | |
18 // possible. | |
19 // | |
20 // Note that only the structural validity is checked and non-character | |
21 // codepoints and unassigned are regarded as valid. | |
22 // TODO(jungshik): Consider replacing an invalid input sequence with | |
23 // the Unicode replacement character or adding |replacement_char| parameter. | |
24 // Currently, it's skipped in the ouput, which could be problematic in | |
25 // some situations. | |
26 bool WideToUTF8(const wchar_t* src, size_t src_len, std::string* output); | |
27 std::string WideToUTF8(const std::wstring& wide); | |
28 bool UTF8ToWide(const char* src, size_t src_len, std::wstring* output); | |
29 std::wstring UTF8ToWide(const base::StringPiece& utf8); | |
30 | |
31 bool WideToUTF16(const wchar_t* src, size_t src_len, string16* output); | |
32 string16 WideToUTF16(const std::wstring& wide); | |
33 bool UTF16ToWide(const char16* src, size_t src_len, std::wstring* output); | |
34 std::wstring UTF16ToWide(const string16& utf16); | |
35 | |
36 bool UTF8ToUTF16(const char* src, size_t src_len, string16* output); | |
37 string16 UTF8ToUTF16(const std::string& utf8); | |
38 bool UTF16ToUTF8(const char16* src, size_t src_len, std::string* output); | |
39 std::string UTF16ToUTF8(const string16& utf16); | |
40 | |
41 // We are trying to get rid of wstring as much as possible, but it's too big | |
42 // a mess to do it all at once. These conversions should be used when we | |
43 // really should just be passing a string16 around, but we haven't finished | |
44 // porting whatever module uses wstring and the conversion is being used as a | |
45 // stopcock. This makes it easy to grep for the ones that should be removed. | |
46 #if defined(OS_WIN) | |
47 # define WideToUTF16Hack | |
48 # define UTF16ToWideHack | |
49 #else | |
50 # define WideToUTF16Hack WideToUTF16 | |
51 # define UTF16ToWideHack UTF16ToWide | |
52 #endif | |
53 | |
54 // Defines the error handling modes of UTF16ToCodepage, CodepageToUTF16, | 13 // Defines the error handling modes of UTF16ToCodepage, CodepageToUTF16, |
55 // WideToCodepage and CodepageToWide. | 14 // WideToCodepage and CodepageToWide. |
56 class OnStringUtilConversionError { | 15 class OnStringUtilConversionError { |
57 public: | 16 public: |
58 enum Type { | 17 enum Type { |
59 // The function will return failure. The output buffer will be empty. | 18 // The function will return failure. The output buffer will be empty. |
60 FAIL, | 19 FAIL, |
61 | 20 |
62 // The offending characters are skipped and the conversion will proceed as | 21 // The offending characters are skipped and the conversion will proceed as |
63 // if they did not exist. | 22 // if they did not exist. |
(...skipping 27 matching lines...) Expand all Loading... |
91 // returns false. | 50 // returns false. |
92 bool WideToCodepage(const std::wstring& wide, | 51 bool WideToCodepage(const std::wstring& wide, |
93 const char* codepage_name, | 52 const char* codepage_name, |
94 OnStringUtilConversionError::Type on_error, | 53 OnStringUtilConversionError::Type on_error, |
95 std::string* encoded); | 54 std::string* encoded); |
96 bool CodepageToWide(const std::string& encoded, | 55 bool CodepageToWide(const std::string& encoded, |
97 const char* codepage_name, | 56 const char* codepage_name, |
98 OnStringUtilConversionError::Type on_error, | 57 OnStringUtilConversionError::Type on_error, |
99 std::wstring* wide); | 58 std::wstring* wide); |
100 | 59 |
101 #endif // BASE_I18N_STRING_CONVERSIONS_H_ | 60 #endif // BASE_I18N_ICU_STRING_CONVERSIONS_H_ |
OLD | NEW |