groby@chromium.org | ce28c93 | 2012-08-04 11:28:36 +0900 | [diff] [blame] | 1 | // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
license.bot | f003cfe | 2008-08-24 09:55:55 +0900 | [diff] [blame] | 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 4 | |
| 5 | #ifndef BASE_SYS_STRING_CONVERSIONS_H_ |
| 6 | #define BASE_SYS_STRING_CONVERSIONS_H_ |
| 7 | |
| 8 | // Provides system-dependent string type conversions for cases where it's |
| 9 | // necessary to not use ICU. Generally, you should not need this in Chrome, |
| 10 | // but it is used in some shared code. Dependencies should be minimal. |
| 11 | |
| 12 | #include <string> |
rvargas@google.com | 73eb5d0 | 2011-03-25 04:00:20 +0900 | [diff] [blame] | 13 | |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 14 | #include "base/base_export.h" |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 15 | #include "base/basictypes.h" |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 16 | #include "base/string16.h" |
erikwright@chromium.org | acc1602 | 2011-12-13 09:13:00 +0900 | [diff] [blame] | 17 | #include "base/string_piece.h" |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 18 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 19 | #if defined(OS_MACOSX) |
| 20 | #include <CoreFoundation/CoreFoundation.h> |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 21 | #ifdef __OBJC__ |
| 22 | @class NSString; |
| 23 | #else |
| 24 | class NSString; |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 25 | #endif |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 26 | #endif // OS_MACOSX |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 27 | |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 28 | namespace base { |
| 29 | |
| 30 | // Converts between wide and UTF-8 representations of a string. On error, the |
| 31 | // result is system-dependent. |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 32 | BASE_EXPORT std::string SysWideToUTF8(const std::wstring& wide); |
| 33 | BASE_EXPORT std::wstring SysUTF8ToWide(const StringPiece& utf8); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 34 | |
| 35 | // Converts between wide and the system multi-byte representations of a string. |
| 36 | // DANGER: This will lose information and can change (on Windows, this can |
brettw@google.com | e3c034a | 2008-08-08 03:31:40 +0900 | [diff] [blame] | 37 | // change between reboots). |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 38 | BASE_EXPORT std::string SysWideToNativeMB(const std::wstring& wide); |
| 39 | BASE_EXPORT std::wstring SysNativeMBToWide(const StringPiece& native_mb); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 40 | |
| 41 | // Windows-specific ------------------------------------------------------------ |
| 42 | |
brettw@google.com | e3c034a | 2008-08-08 03:31:40 +0900 | [diff] [blame] | 43 | #if defined(OS_WIN) |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 44 | |
mmentovai@google.com | af21869 | 2008-08-08 04:31:16 +0900 | [diff] [blame] | 45 | // Converts between 8-bit and wide strings, using the given code page. The |
| 46 | // code page identifier is one accepted by the Windows function |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 47 | // MultiByteToWideChar(). |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 48 | BASE_EXPORT std::wstring SysMultiByteToWide(const StringPiece& mb, |
| 49 | uint32 code_page); |
| 50 | BASE_EXPORT std::string SysWideToMultiByte(const std::wstring& wide, |
| 51 | uint32 code_page); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 52 | |
brettw@google.com | e3c034a | 2008-08-08 03:31:40 +0900 | [diff] [blame] | 53 | #endif // defined(OS_WIN) |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 54 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 55 | // Mac-specific ---------------------------------------------------------------- |
maruel@chromium.org | 8fe7adc | 2009-03-04 00:01:12 +0900 | [diff] [blame] | 56 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 57 | #if defined(OS_MACOSX) |
maruel@chromium.org | 8fe7adc | 2009-03-04 00:01:12 +0900 | [diff] [blame] | 58 | |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 59 | // Converts between STL strings and CFStringRefs/NSStrings. |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 60 | |
| 61 | // Creates a string, and returns it with a refcount of 1. You are responsible |
| 62 | // for releasing it. Returns NULL on failure. |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 63 | BASE_EXPORT CFStringRef SysUTF8ToCFStringRef(const std::string& utf8); |
| 64 | BASE_EXPORT CFStringRef SysUTF16ToCFStringRef(const string16& utf16); |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 65 | |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 66 | // Same, but returns an autoreleased NSString. |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 67 | BASE_EXPORT NSString* SysUTF8ToNSString(const std::string& utf8); |
| 68 | BASE_EXPORT NSString* SysUTF16ToNSString(const string16& utf16); |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 69 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 70 | // Converts a CFStringRef to an STL string. Returns an empty string on failure. |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 71 | BASE_EXPORT std::string SysCFStringRefToUTF8(CFStringRef ref); |
| 72 | BASE_EXPORT string16 SysCFStringRefToUTF16(CFStringRef ref); |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 73 | |
mirandac@chromium.org | 6968934 | 2009-11-09 04:04:54 +0900 | [diff] [blame] | 74 | // Same, but accepts NSString input. Converts nil NSString* to the appropriate |
| 75 | // string type of length 0. |
darin@chromium.org | e585bed | 2011-08-06 00:34:00 +0900 | [diff] [blame] | 76 | BASE_EXPORT std::string SysNSStringToUTF8(NSString* ref); |
| 77 | BASE_EXPORT string16 SysNSStringToUTF16(NSString* ref); |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 78 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 79 | #endif // defined(OS_MACOSX) |
maruel@chromium.org | 8fe7adc | 2009-03-04 00:01:12 +0900 | [diff] [blame] | 80 | |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 81 | } // namespace base |
| 82 | |
| 83 | #endif // BASE_SYS_STRING_CONVERSIONS_H_ |