license.bot | f003cfe | 2008-08-24 09:55:55 +0900 | [diff] [blame] | 1 | // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. |
| 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> |
| 13 | #include "base/basictypes.h" |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 14 | #include "base/string16.h" |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 15 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 16 | #if defined(OS_MACOSX) |
| 17 | #include <CoreFoundation/CoreFoundation.h> |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 18 | #ifdef __OBJC__ |
| 19 | @class NSString; |
| 20 | #else |
| 21 | class NSString; |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 22 | #endif |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 23 | #endif // OS_MACOSX |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 24 | |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 25 | namespace base { |
| 26 | |
tony@chromium.org | b84e9bd | 2009-09-11 06:08:39 +0900 | [diff] [blame] | 27 | class StringPiece; |
| 28 | |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 29 | // Converts between wide and UTF-8 representations of a string. On error, the |
| 30 | // result is system-dependent. |
| 31 | std::string SysWideToUTF8(const std::wstring& wide); |
deanm@google.com | 74c2de4 | 2008-08-20 20:17:00 +0900 | [diff] [blame] | 32 | std::wstring SysUTF8ToWide(const StringPiece& utf8); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 33 | |
| 34 | // Converts between wide and the system multi-byte representations of a string. |
| 35 | // 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] | 36 | // change between reboots). |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 37 | std::string SysWideToNativeMB(const std::wstring& wide); |
deanm@google.com | 74c2de4 | 2008-08-20 20:17:00 +0900 | [diff] [blame] | 38 | std::wstring SysNativeMBToWide(const StringPiece& native_mb); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 39 | |
| 40 | // Windows-specific ------------------------------------------------------------ |
| 41 | |
brettw@google.com | e3c034a | 2008-08-08 03:31:40 +0900 | [diff] [blame] | 42 | #if defined(OS_WIN) |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 43 | |
mmentovai@google.com | af21869 | 2008-08-08 04:31:16 +0900 | [diff] [blame] | 44 | // Converts between 8-bit and wide strings, using the given code page. The |
| 45 | // code page identifier is one accepted by the Windows function |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 46 | // MultiByteToWideChar(). |
deanm@google.com | 74c2de4 | 2008-08-20 20:17:00 +0900 | [diff] [blame] | 47 | std::wstring SysMultiByteToWide(const StringPiece& mb, uint32 code_page); |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 48 | std::string SysWideToMultiByte(const std::wstring& wide, uint32 code_page); |
| 49 | |
brettw@google.com | e3c034a | 2008-08-08 03:31:40 +0900 | [diff] [blame] | 50 | #endif // defined(OS_WIN) |
brettw@google.com | 7bea9d1 | 2008-08-07 12:11:42 +0900 | [diff] [blame] | 51 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 52 | // Mac-specific ---------------------------------------------------------------- |
maruel@chromium.org | 8fe7adc | 2009-03-04 00:01:12 +0900 | [diff] [blame] | 53 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 54 | #if defined(OS_MACOSX) |
maruel@chromium.org | 8fe7adc | 2009-03-04 00:01:12 +0900 | [diff] [blame] | 55 | |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 56 | // Converts between STL strings and CFStringRefs/NSStrings. |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 57 | |
| 58 | // Creates a string, and returns it with a refcount of 1. You are responsible |
| 59 | // for releasing it. Returns NULL on failure. |
| 60 | CFStringRef SysUTF8ToCFStringRef(const std::string& utf8); |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 61 | CFStringRef SysUTF16ToCFStringRef(const string16& utf16); |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 62 | CFStringRef SysWideToCFStringRef(const std::wstring& wide); |
| 63 | |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 64 | // Same, but returns an autoreleased NSString. |
| 65 | NSString* SysUTF8ToNSString(const std::string& utf8); |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 66 | NSString* SysUTF16ToNSString(const string16& utf16); |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 67 | NSString* SysWideToNSString(const std::wstring& wide); |
| 68 | |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 69 | // Converts a CFStringRef to an STL string. Returns an empty string on failure. |
| 70 | std::string SysCFStringRefToUTF8(CFStringRef ref); |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 71 | string16 SysCFStringRefToUTF16(CFStringRef ref); |
avi@google.com | 0edcae8 | 2008-08-23 04:55:26 +0900 | [diff] [blame] | 72 | std::wstring SysCFStringRefToWide(CFStringRef ref); |
| 73 | |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 74 | // Same, but accepts NSString input. |
| 75 | std::string SysNSStringToUTF8(NSString* ref); |
avi@chromium.org | 727451f | 2009-02-19 06:39:23 +0900 | [diff] [blame] | 76 | string16 SysNSStringToUTF16(NSString* ref); |
mark@chromium.org | e27eae1 | 2008-10-09 06:02:56 +0900 | [diff] [blame] | 77 | std::wstring SysNSStringToWide(NSString* ref); |
| 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_ |