utf_string_conversions.h revision c407dc5cd9bdc5668497f21b26b09d988ab439de 
1// Copyright (c) 2009 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.
4
5#ifndef BASE_UTF_STRING_CONVERSIONS_H_
6#define BASE_UTF_STRING_CONVERSIONS_H_
7
8#include <string>
9
10#include "base/string16.h"
11
12namespace base {
13class StringPiece;
14}
15
16// These convert between UTF-8, -16, and -32 strings. They are potentially slow,
17// so avoid unnecessary conversions. The low-level versions return a boolean
18// indicating whether the conversion was 100% valid. In this case, it will still
19// do the best it can and put the result in the output buffer. The versions that
20// return strings ignore this error and just return the best conversion
21// possible.
22bool WideToUTF8(const wchar_t* src, size_t src_len, std::string* output);
23std::string WideToUTF8(const std::wstring& wide);
24bool UTF8ToWide(const char* src, size_t src_len, std::wstring* output);
25std::wstring UTF8ToWide(const base::StringPiece& utf8);
26
27bool WideToUTF16(const wchar_t* src, size_t src_len, string16* output);
28string16 WideToUTF16(const std::wstring& wide);
29bool UTF16ToWide(const char16* src, size_t src_len, std::wstring* output);
30std::wstring UTF16ToWide(const string16& utf16);
31
32bool UTF8ToUTF16(const char* src, size_t src_len, string16* output);
33string16 UTF8ToUTF16(const std::string& utf8);
34bool UTF16ToUTF8(const char16* src, size_t src_len, std::string* output);
35std::string UTF16ToUTF8(const string16& utf16);
36
37// We are trying to get rid of wstring as much as possible, but it's too big
38// a mess to do it all at once.  These conversions should be used when we
39// really should just be passing a string16 around, but we haven't finished
40// porting whatever module uses wstring and the conversion is being used as a
41// stopcock.  This makes it easy to grep for the ones that should be removed.
42#if defined(OS_WIN)
43# define WideToUTF16Hack
44# define UTF16ToWideHack
45#else
46# define WideToUTF16Hack WideToUTF16
47# define UTF16ToWideHack UTF16ToWide
48#endif
49
50#endif  // BASE_UTF_STRING_CONVERSIONS_H_
51