net_string_util.h revision 5c02ac1a9c1b504631c0a3d2b6e737b5d738bae1
1// Copyright 2014 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 NET_BASE_NET_STRING_UTIL_H__
6#define NET_BASE_NET_STRING_UTIL_H__
7
8#include <string>
9
10#include "base/strings/string16.h"
11
12// String conversion functions.  By default, they're implemented with ICU, but
13// when building with USE_ICU_ALTERNATIVES, they use platform functions instead.
14
15namespace net {
16
17// Converts |text| using |charset| to UTF-8, and writes it to |output|.
18// On failure, returns false and |output| is cleared.
19bool ConvertToUtf8(const std::string& text, const char* charset,
20                   std::string* output);
21
22// Converts |text| using |charset| to UTF-8, normalizes the result, and writes
23// it to |output|.  On failure, returns false and |output| is cleared.
24bool ConvertToUtf8AndNormalize(const std::string& text, const char* charset,
25                               std::string* output);
26
27// Converts |text| encoded in Latin-1 to UTF-8, normalizes the result, and
28// writes it to |output|.  On failure, returns false and |output| is cleared.
29bool ConvertLatin1ToUtf8AndNormalize(const std::string& text,
30                                     std::string* output);
31
32// Converts |text| using |charset| to UTF-16, and writes it to |output|.
33// On failure, returns false and |output| is cleared.
34bool ConvertToUTF16(const std::string& text, const char* charset,
35                    base::string16* output);
36
37// Converts |text| encoded in Latin-1 to UTF-16, and writes it to |output|.
38// On failure, returns false and |output| is cleared.
39bool ConvertLatin1ToUTF16(const std::string& text, base::string16* output);
40
41}  // namespace net
42
43#endif  // NET_BASE_NET_STRING_UTIL_H__
44