OLD | NEW |
1 // Copyright (c) 2011 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_SYS_STRING_CONVERSIONS_H_ | 5 #ifndef BASE_SYS_STRING_CONVERSIONS_H_ |
6 #define BASE_SYS_STRING_CONVERSIONS_H_ | 6 #define BASE_SYS_STRING_CONVERSIONS_H_ |
7 #pragma once | 7 #pragma once |
8 | 8 |
9 // Provides system-dependent string type conversions for cases where it's | 9 // Provides system-dependent string type conversions for cases where it's |
10 // necessary to not use ICU. Generally, you should not need this in Chrome, | 10 // necessary to not use ICU. Generally, you should not need this in Chrome, |
11 // but it is used in some shared code. Dependencies should be minimal. | 11 // but it is used in some shared code. Dependencies should be minimal. |
12 | 12 |
13 #include <string> | 13 #include <string> |
14 | 14 |
15 #include "base/base_api.h" | 15 #include "base/base_export.h" |
16 #include "base/basictypes.h" | 16 #include "base/basictypes.h" |
17 #include "base/string16.h" | 17 #include "base/string16.h" |
18 | 18 |
19 #if defined(OS_MACOSX) | 19 #if defined(OS_MACOSX) |
20 #include <CoreFoundation/CoreFoundation.h> | 20 #include <CoreFoundation/CoreFoundation.h> |
21 #ifdef __OBJC__ | 21 #ifdef __OBJC__ |
22 @class NSString; | 22 @class NSString; |
23 #else | 23 #else |
24 class NSString; | 24 class NSString; |
25 #endif | 25 #endif |
26 #endif // OS_MACOSX | 26 #endif // OS_MACOSX |
27 | 27 |
28 namespace base { | 28 namespace base { |
29 | 29 |
30 class StringPiece; | 30 class StringPiece; |
31 | 31 |
32 // Converts between wide and UTF-8 representations of a string. On error, the | 32 // Converts between wide and UTF-8 representations of a string. On error, the |
33 // result is system-dependent. | 33 // result is system-dependent. |
34 BASE_API std::string SysWideToUTF8(const std::wstring& wide); | 34 BASE_EXPORT std::string SysWideToUTF8(const std::wstring& wide); |
35 BASE_API std::wstring SysUTF8ToWide(const StringPiece& utf8); | 35 BASE_EXPORT std::wstring SysUTF8ToWide(const StringPiece& utf8); |
36 | 36 |
37 // Converts between wide and the system multi-byte representations of a string. | 37 // Converts between wide and the system multi-byte representations of a string. |
38 // DANGER: This will lose information and can change (on Windows, this can | 38 // DANGER: This will lose information and can change (on Windows, this can |
39 // change between reboots). | 39 // change between reboots). |
40 BASE_API std::string SysWideToNativeMB(const std::wstring& wide); | 40 BASE_EXPORT std::string SysWideToNativeMB(const std::wstring& wide); |
41 BASE_API std::wstring SysNativeMBToWide(const StringPiece& native_mb); | 41 BASE_EXPORT std::wstring SysNativeMBToWide(const StringPiece& native_mb); |
42 | 42 |
43 // Windows-specific ------------------------------------------------------------ | 43 // Windows-specific ------------------------------------------------------------ |
44 | 44 |
45 #if defined(OS_WIN) | 45 #if defined(OS_WIN) |
46 | 46 |
47 // Converts between 8-bit and wide strings, using the given code page. The | 47 // Converts between 8-bit and wide strings, using the given code page. The |
48 // code page identifier is one accepted by the Windows function | 48 // code page identifier is one accepted by the Windows function |
49 // MultiByteToWideChar(). | 49 // MultiByteToWideChar(). |
50 BASE_API std::wstring SysMultiByteToWide(const StringPiece& mb, | 50 BASE_EXPORT std::wstring SysMultiByteToWide(const StringPiece& mb, |
51 uint32 code_page); | 51 uint32 code_page); |
52 BASE_API std::string SysWideToMultiByte(const std::wstring& wide, | 52 BASE_EXPORT std::string SysWideToMultiByte(const std::wstring& wide, |
53 uint32 code_page); | 53 uint32 code_page); |
54 | 54 |
55 #endif // defined(OS_WIN) | 55 #endif // defined(OS_WIN) |
56 | 56 |
57 // Mac-specific ---------------------------------------------------------------- | 57 // Mac-specific ---------------------------------------------------------------- |
58 | 58 |
59 #if defined(OS_MACOSX) | 59 #if defined(OS_MACOSX) |
60 | 60 |
61 // Converts between STL strings and CFStringRefs/NSStrings. | 61 // Converts between STL strings and CFStringRefs/NSStrings. |
62 | 62 |
63 // Creates a string, and returns it with a refcount of 1. You are responsible | 63 // Creates a string, and returns it with a refcount of 1. You are responsible |
64 // for releasing it. Returns NULL on failure. | 64 // for releasing it. Returns NULL on failure. |
65 BASE_API CFStringRef SysUTF8ToCFStringRef(const std::string& utf8); | 65 BASE_EXPORT CFStringRef SysUTF8ToCFStringRef(const std::string& utf8); |
66 BASE_API CFStringRef SysUTF16ToCFStringRef(const string16& utf16); | 66 BASE_EXPORT CFStringRef SysUTF16ToCFStringRef(const string16& utf16); |
67 BASE_API CFStringRef SysWideToCFStringRef(const std::wstring& wide); | 67 BASE_EXPORT CFStringRef SysWideToCFStringRef(const std::wstring& wide); |
68 | 68 |
69 // Same, but returns an autoreleased NSString. | 69 // Same, but returns an autoreleased NSString. |
70 BASE_API NSString* SysUTF8ToNSString(const std::string& utf8); | 70 BASE_EXPORT NSString* SysUTF8ToNSString(const std::string& utf8); |
71 BASE_API NSString* SysUTF16ToNSString(const string16& utf16); | 71 BASE_EXPORT NSString* SysUTF16ToNSString(const string16& utf16); |
72 BASE_API NSString* SysWideToNSString(const std::wstring& wide); | 72 BASE_EXPORT NSString* SysWideToNSString(const std::wstring& wide); |
73 | 73 |
74 // Converts a CFStringRef to an STL string. Returns an empty string on failure. | 74 // Converts a CFStringRef to an STL string. Returns an empty string on failure. |
75 BASE_API std::string SysCFStringRefToUTF8(CFStringRef ref); | 75 BASE_EXPORT std::string SysCFStringRefToUTF8(CFStringRef ref); |
76 BASE_API string16 SysCFStringRefToUTF16(CFStringRef ref); | 76 BASE_EXPORT string16 SysCFStringRefToUTF16(CFStringRef ref); |
77 BASE_API std::wstring SysCFStringRefToWide(CFStringRef ref); | 77 BASE_EXPORT std::wstring SysCFStringRefToWide(CFStringRef ref); |
78 | 78 |
79 // Same, but accepts NSString input. Converts nil NSString* to the appropriate | 79 // Same, but accepts NSString input. Converts nil NSString* to the appropriate |
80 // string type of length 0. | 80 // string type of length 0. |
81 BASE_API std::string SysNSStringToUTF8(NSString* ref); | 81 BASE_EXPORT std::string SysNSStringToUTF8(NSString* ref); |
82 BASE_API string16 SysNSStringToUTF16(NSString* ref); | 82 BASE_EXPORT string16 SysNSStringToUTF16(NSString* ref); |
83 BASE_API std::wstring SysNSStringToWide(NSString* ref); | 83 BASE_EXPORT std::wstring SysNSStringToWide(NSString* ref); |
84 | 84 |
85 #endif // defined(OS_MACOSX) | 85 #endif // defined(OS_MACOSX) |
86 | 86 |
87 } // namespace base | 87 } // namespace base |
88 | 88 |
89 #endif // BASE_SYS_STRING_CONVERSIONS_H_ | 89 #endif // BASE_SYS_STRING_CONVERSIONS_H_ |
OLD | NEW |