// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef BASE_STRINGS_SYS_STRING_CONVERSIONS_H_ #define BASE_STRINGS_SYS_STRING_CONVERSIONS_H_ // Provides system-dependent string type conversions for cases where it's // necessary to not use ICU. Generally, you should not need this in Chrome, // but it is used in some shared code. Dependencies should be minimal. #include #include #include "base/base_export.h" #include "base/strings/string_piece.h" #include "build/build_config.h" #if BUILDFLAG(IS_APPLE) #include #include "base/mac/scoped_cftyperef.h" #ifdef __OBJC__ @class NSString; #endif #endif // BUILDFLAG(IS_APPLE) namespace base { // Converts between wide and UTF-8 representations of a string. On error, the // result is system-dependent. [[nodiscard]] BASE_EXPORT std::string SysWideToUTF8(const std::wstring& wide); [[nodiscard]] BASE_EXPORT std::wstring SysUTF8ToWide(StringPiece utf8); // Converts between wide and the system multi-byte representations of a string. // DANGER: This will lose information and can change (on Windows, this can // change between reboots). [[nodiscard]] BASE_EXPORT std::string SysWideToNativeMB( const std::wstring& wide); [[nodiscard]] BASE_EXPORT std::wstring SysNativeMBToWide(StringPiece native_mb); // Windows-specific ------------------------------------------------------------ #if BUILDFLAG(IS_WIN) // Converts between 8-bit and wide strings, using the given code page. The // code page identifier is one accepted by the Windows function // MultiByteToWideChar(). [[nodiscard]] BASE_EXPORT std::wstring SysMultiByteToWide(StringPiece mb, uint32_t code_page); [[nodiscard]] BASE_EXPORT std::string SysWideToMultiByte( const std::wstring& wide, uint32_t code_page); #endif // BUILDFLAG(IS_WIN) // Mac-specific ---------------------------------------------------------------- #if BUILDFLAG(IS_APPLE) // Converts between strings and CFStringRefs/NSStrings. // Converts a string to a CFStringRef. Returns null on failure. [[nodiscard]] BASE_EXPORT ScopedCFTypeRef SysUTF8ToCFStringRef( StringPiece utf8); [[nodiscard]] BASE_EXPORT ScopedCFTypeRef SysUTF16ToCFStringRef( StringPiece16 utf16); // Converts a CFStringRef to a string. Returns an empty string on failure. It is // not valid to call these with a null `ref`. [[nodiscard]] BASE_EXPORT std::string SysCFStringRefToUTF8(CFStringRef ref); [[nodiscard]] BASE_EXPORT std::u16string SysCFStringRefToUTF16(CFStringRef ref); #ifdef __OBJC__ // Converts a string to an autoreleased NSString. Returns nil on failure. [[nodiscard]] BASE_EXPORT NSString* SysUTF8ToNSString(StringPiece utf8); [[nodiscard]] BASE_EXPORT NSString* SysUTF16ToNSString(StringPiece16 utf16); // Converts an NSString to a string. Returns an empty string on failure or if // `ref` is nil. [[nodiscard]] BASE_EXPORT std::string SysNSStringToUTF8(NSString* ref); [[nodiscard]] BASE_EXPORT std::u16string SysNSStringToUTF16(NSString* ref); #endif // __OBJC__ #endif // BUILDFLAG(IS_APPLE) } // namespace base #endif // BASE_STRINGS_SYS_STRING_CONVERSIONS_H_