1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
/* 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.
*/
/**
* This file defines the <code>PPB_CharSet_Dev</code> interface.
*/
label Chrome {
M14 = 0.4
};
[assert_size(4)] enum PP_CharSet_ConversionError {
/**
* Causes the entire conversion to fail if an error is encountered. The
* conversion function will return NULL.
*/
PP_CHARSET_CONVERSIONERROR_FAIL,
/**
* Silently skips over errors. Unrepresentable characters and input encoding
* errors will be removed from the output.
*/
PP_CHARSET_CONVERSIONERROR_SKIP,
/**
* Replaces the error or unrepresentable character with a substitution
* character. When converting to a Unicode character set (UTF-8 or UTF-16) it
* will use the unicode "substitution character" U+FFFD. When converting to
* another character set, the character will be charset-specific. For many
* languages this will be the representation of the '?' character.
*/
PP_CHARSET_CONVERSIONERROR_SUBSTITUTE
};
[version=0.0]
describe {
uint16_ptr_t;
};
#inline c
typedef uint16_t* uint16_ptr_t;
#endinl
/**
* The <code>PPB_CharSet_Trusted</code> interface provides functions for
* converting between character sets.
*
* This inteface is provided for trusted plugins only since in Native Client it
* would require an expensive out-of-process IPC call for each conversion,
* which makes performance unacceptable. Native Client plugins should include
* ICU or some other library if they need this feature.
*/
interface PPB_CharSet_Dev {
/**
* Converts the UTF-16 string pointed to by |*utf16| to an 8-bit string in
* the specified code page. |utf16_len| is measured in UTF-16 units, not
* bytes. This value may not be NULL.
*
* The given output buffer will be filled up to output_length bytes with the
* result. output_length will be updated with the number of bytes required
* for the given string. The output buffer may be null to just retrieve the
* required buffer length.
*
* This function will return PP_FALSE if there was an error converting the
* string and you requested PP_CHARSET_CONVERSIONERROR_FAIL, or the output
* character set was unknown. Otherwise, it will return PP_TRUE.
*/
str_t UTF16ToCharSet([in] PP_Instance instance,
[in, size_as=utf16_len] uint16_t[] utf16,
[in] uint32_t utf16_len,
[in] str_t output_char_set,
[in] PP_CharSet_ConversionError on_error,
[out] uint32_t output_length);
/**
* Same as UTF16ToCharSet except converts in the other direction. The input
* is in the given charset, and the |input_len| is the number of bytes in
* the |input| string.
*
* Note that the output_utf16_length is measured in UTF-16 characters.
*
* Since UTF16 can represent every Unicode character, the only time the
* replacement character will be used is if the encoding in the input string
* is incorrect.
*/
uint16_ptr_t CharSetToUTF16([in] PP_Instance instance,
[in] str_t input,
[in] uint32_t input_len,
[in] str_t input_char_set,
[in] PP_CharSet_ConversionError on_error,
[out] uint32_t output_utf16_length);
/**
* Returns a string var representing the current multi-byte character set of
* the current system.
*
* WARNING: You really shouldn't be using this function unless you're dealing
* with legacy data. You should be using UTF-8 or UTF-16 and you don't have
* to worry about the character sets.
*/
PP_Var GetDefaultCharSet([in] PP_Instance instance);
};
|
