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
|
/*
* 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.
*/
/*
* Array handling.
*/
#ifndef DALVIK_OO_ARRAY_H_
#define DALVIK_OO_ARRAY_H_
/*
* Find a matching array class. If it doesn't exist, create it.
*
* "descriptor" looks like "[I".
*
* "loader" should be the defining class loader for the elements held
* in the array.
*/
ClassObject* dvmFindArrayClass(const char* descriptor, Object* loader);
/*
* Find the array class for the specified class. If "elemClassObj" is the
* class "Foo", this returns the class object for "[Foo".
*/
ClassObject* dvmFindArrayClassForElement(ClassObject* elemClassObj);
/*
* Create a new array, given an array class. The class may represent an
* array of references or primitives.
*
* Returns NULL with an exception raised if allocation fails.
*/
extern "C" ArrayObject* dvmAllocArrayByClass(ClassObject* arrayClass,
size_t length, int allocFlags);
/*
* Allocate an array whose members are primitives (bools, ints, etc.).
*
* "type" should be 'I', 'J', 'Z', etc.
*
* The new object will be added to the "tracked alloc" table.
*
* Returns NULL with an exception raised if allocation fails.
*/
ArrayObject* dvmAllocPrimitiveArray(char type, size_t length, int allocFlags);
/*
* Allocate an array with multiple dimensions. Elements may be Objects or
* primitive types.
*
* The base object will be added to the "tracked alloc" table.
*
* Returns NULL with an exception raised if allocation fails.
*/
ArrayObject* dvmAllocMultiArray(ClassObject* arrayClass, int curDim,
const int* dimensions);
/*
* Verify that the object is actually an array.
*
* Does not verify that the object is actually a non-NULL object.
*/
INLINE bool dvmIsArray(const ArrayObject* arrayObj)
{
return ( ((Object*)arrayObj)->clazz->descriptor[0] == '[' );
}
/*
* Verify that the array is an object array and not a primitive array.
*
* Does not verify that the object is actually a non-NULL object.
*/
INLINE bool dvmIsObjectArrayClass(const ClassObject* clazz)
{
const char* descriptor = clazz->descriptor;
return descriptor[0] == '[' && (descriptor[1] == 'L' ||
descriptor[1] == '[');
}
/*
* Verify that the array is an object array and not a primitive array.
*
* Does not verify that the object is actually a non-NULL object.
*/
INLINE bool dvmIsObjectArray(const ArrayObject* arrayObj)
{
return dvmIsObjectArrayClass(arrayObj->clazz);
}
/*
* Verify that the class is an array class.
*
* TODO: there may be some performance advantage to setting a flag in
* the accessFlags field instead of chasing into the name string.
*/
INLINE bool dvmIsArrayClass(const ClassObject* clazz)
{
return (clazz->descriptor[0] == '[');
}
/*
* Copy the entire contents of one array of objects to another. If the copy
* is impossible because of a type clash, we fail and return "false".
*
* "dstElemClass" is the type of element that "dstArray" holds.
*/
bool dvmCopyObjectArray(ArrayObject* dstArray, const ArrayObject* srcArray,
ClassObject* dstElemClass);
/*
* Copy the entire contents of an array of boxed primitives into an
* array of primitives. The boxed value must fit in the primitive (i.e.
* narrowing conversions are not allowed).
*/
bool dvmUnboxObjectArray(ArrayObject* dstArray, const ArrayObject* srcArray,
ClassObject* dstElemClass);
/*
* Returns the size of the given array object in bytes.
*/
size_t dvmArrayObjectSize(const ArrayObject *array);
/*
* Returns the width, in bytes, required by elements in instances of
* the array class.
*/
size_t dvmArrayClassElementWidth(const ClassObject* clazz);
#endif // DALVIK_OO_ARRAY_H_
|
