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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/*
* Copyright (C) 2008 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* UTF-8 and Unicode string manipulation functions, plus convenience
* functions for working with java/lang/String.
*/
#ifndef _DALVIK_STRING
#define _DALVIK_STRING
#ifdef __cplusplus
extern "C" {
#endif
/*
* (This is private to UtfString.c, but we cheat a bit and also use it
* for InlineNative.c. Not really worth creating a separate header.)
*
* We can avoid poking around in gDvm by hard-coding the expected values of
* the String field offsets. This will be annoying if String is in flux
* or the VM field layout is changing, so we use defines here to make it
* easy to switch back to the gDvm version.
*
* The values are checked for correctness during startup.
*/
//#define USE_GLOBAL_STRING_DEFS
#ifdef USE_GLOBAL_STRING_DEFS
# define STRING_FIELDOFF_VALUE gDvm.offJavaLangString_value
# define STRING_FIELDOFF_OFFSET gDvm.offJavaLangString_offset
# define STRING_FIELDOFF_COUNT gDvm.offJavaLangString_count
# define STRING_FIELDOFF_HASHCODE gDvm.offJavaLangString_hashCode
#else
# define STRING_FIELDOFF_VALUE 8
# define STRING_FIELDOFF_HASHCODE 12
# define STRING_FIELDOFF_OFFSET 16
# define STRING_FIELDOFF_COUNT 20
#endif
/*
* Hash function for modified UTF-8 strings.
*/
u4 dvmComputeUtf8Hash(const char* str);
/*
* Hash function for string objects.
*/
u4 dvmComputeStringHash(const StringObject* strObj);
/*
* Create a java.lang.String[] from an array of C strings.
*
* The caller must call dvmReleaseTrackedAlloc() on the returned array,
* but not on the individual elements.
*
* Returns NULL and throws an exception on failure.
*/
ArrayObject* dvmCreateStringArray(const char** strings, size_t count);
/*
* Create a java/lang/String from a C string.
*
* The caller must call dvmReleaseTrackedAlloc() on the return value.
*
* Returns NULL and throws an exception on failure.
*/
StringObject* dvmCreateStringFromCstr(const char* utf8Str);
/*
* Create a java/lang/String from a C string, given its UTF-16 length
* (number of UTF-16 code points).
*
* The caller must call dvmReleaseTrackedAlloc() on the return value.
*
* Returns NULL and throws an exception on failure.
*/
StringObject* dvmCreateStringFromCstrAndLength(const char* utf8Str,
u4 utf16Length);
/*
* Compute the number of characters in a "modified UTF-8" string. This will
* match the result from strlen() so long as there are no multi-byte chars.
*/
int dvmUtf8Len(const char* utf8Str);
/*
* Convert a UTF-8 string to UTF-16. "utf16Str" must have enough room
* to hold the output.
*/
void dvmConvertUtf8ToUtf16(u2* utf16Str, const char* utf8Str);
/*
* Create a java/lang/String from a Unicode string.
*
* The caller must call dvmReleaseTrackedAlloc() on the return value.
*/
StringObject* dvmCreateStringFromUnicode(const u2* unichars, int len);
/*
* Create a UTF-8 C string from a java/lang/String. Caller must free
* the result.
*
* Returns NULL if "jstr" is NULL.
*/
char* dvmCreateCstrFromString(StringObject* jstr);
/*
* Create a UTF-8 C string from a region of a java/lang/String. (Used by
* the JNI GetStringUTFRegion call.)
*/
void dvmCreateCstrFromStringRegion(StringObject* jstr, int start, int len,
char* buf);
/*
* Compute the length in bytes of the modified UTF-8 representation of a
* string.
*/
int dvmStringUtf8ByteLen(StringObject* jstr);
/*
* Get the length in Unicode characters of a string.
*/
int dvmStringLen(StringObject* jstr);
/*
* Get the char[] object from the String.
*/
ArrayObject* dvmStringCharArray(StringObject* jstr);
/*
* Get a pointer to the Unicode data.
*/
const u2* dvmStringChars(StringObject* jstr);
/*
* Compare two string objects. (This is a dvmHashTableLookup() callback.)
*/
int dvmHashcmpStrings(const void* vstrObj1, const void* vstrObj2);
#ifdef __cplusplus
}
#endif
#endif /*_DALVIK_STRING*/
|
