1 | // Copyright (c) 2006, Google Inc. |
2 | // All rights reserved. |
3 | // |
4 | // Redistribution and use in source and binary forms, with or without |
5 | // modification, are permitted provided that the following conditions are |
6 | // met: |
7 | // |
8 | // * Redistributions of source code must retain the above copyright |
9 | // notice, this list of conditions and the following disclaimer. |
10 | // * Redistributions in binary form must reproduce the above |
11 | // copyright notice, this list of conditions and the following disclaimer |
12 | // in the documentation and/or other materials provided with the |
13 | // distribution. |
14 | // * Neither the name of Google Inc. nor the names of its |
15 | // contributors may be used to endorse or promote products derived from |
16 | // this software without specific prior written permission. |
17 | // |
18 | // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
19 | // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
20 | // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
21 | // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
22 | // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
23 | // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
24 | // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
25 | // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
26 | // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
27 | // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
28 | // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
29 | |
30 | // string_conversion.h: Conversion between different UTF-8/16/32 encodings. |
31 | |
32 | #ifndef COMMON_STRING_CONVERSION_H__ |
33 | #define COMMON_STRING_CONVERSION_H__ |
34 | |
35 | #include <string> |
36 | #include <vector> |
37 | |
38 | #include "common/using_std_string.h" |
39 | #include "google_breakpad/common/breakpad_types.h" |
40 | |
41 | namespace google_breakpad { |
42 | |
43 | using std::vector; |
44 | |
45 | // Convert |in| to UTF-16 into |out|. Use platform byte ordering. If the |
46 | // conversion failed, |out| will be zero length. |
47 | void UTF8ToUTF16(const char* in, vector<uint16_t>* out); |
48 | |
49 | // Convert at least one character (up to a maximum of |in_length|) from |in| |
50 | // to UTF-16 into |out|. Return the number of characters consumed from |in|. |
51 | // Any unused characters in |out| will be initialized to 0. No memory will |
52 | // be allocated by this routine. |
53 | int UTF8ToUTF16Char(const char* in, int in_length, uint16_t out[2]); |
54 | |
55 | // Convert |in| to UTF-16 into |out|. Use platform byte ordering. If the |
56 | // conversion failed, |out| will be zero length. |
57 | void UTF32ToUTF16(const wchar_t* in, vector<uint16_t>* out); |
58 | |
59 | // Convert |in| to UTF-16 into |out|. Any unused characters in |out| will be |
60 | // initialized to 0. No memory will be allocated by this routine. |
61 | void UTF32ToUTF16Char(wchar_t in, uint16_t out[2]); |
62 | |
63 | // Convert |in| to UTF-8. If |swap| is true, swap bytes before converting. |
64 | string UTF16ToUTF8(const vector<uint16_t>& in, bool swap); |
65 | |
66 | } // namespace google_breakpad |
67 | |
68 | #endif // COMMON_STRING_CONVERSION_H__ |
69 | |