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