* doc/install.texi (Prerequisites): Refine some wording on
[official-gcc.git] / gcc / java / constants.c
blob5d2f6785356afddc34cedffa58ae5bb7c73e991b
1 /* Handle the constant pool of the Java(TM) Virtual Machine.
2 Copyright (C) 1997, 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006
3 Free Software Foundation, Inc.
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2, or (at your option)
10 any later version.
12 GCC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING. If not, write to
18 the Free Software Foundation, 51 Franklin Street, Fifth Floor,
19 Boston, MA 02110-1301, USA.
21 Java and all Java-based marks are trademarks or registered trademarks
22 of Sun Microsystems, Inc. in the United States and other countries.
23 The Free Software Foundation is independent of Sun Microsystems, Inc. */
25 #include "config.h"
26 #include "system.h"
27 #include "coretypes.h"
28 #include "tm.h"
29 #include "jcf.h"
30 #include "tree.h"
31 #include "java-tree.h"
32 #include "toplev.h"
33 #include "ggc.h"
35 static void set_constant_entry (CPool *, int, int, jword);
36 static int find_tree_constant (CPool *, int, tree);
37 static int find_class_or_string_constant (CPool *, int, tree);
38 static int find_name_and_type_constant (CPool *, tree, tree);
39 static tree get_tag_node (int);
40 static tree build_constant_data_ref (void);
41 static CPool *cpool_for_class (tree);
43 /* Set the INDEX'th constant in CPOOL to have the given TAG and VALUE. */
45 static void
46 set_constant_entry (CPool *cpool, int index, int tag, jword value)
48 if (cpool->data == NULL)
50 cpool->capacity = 100;
51 cpool->tags = ggc_alloc_cleared (sizeof(uint8) * cpool->capacity);
52 cpool->data = ggc_alloc_cleared (sizeof(union cpool_entry)
53 * cpool->capacity);
54 cpool->count = 1;
56 if (index >= cpool->capacity)
58 int old_cap = cpool->capacity;
59 cpool->capacity *= 2;
60 if (index >= cpool->capacity)
61 cpool->capacity = index + 10;
62 cpool->tags = ggc_realloc (cpool->tags,
63 sizeof(uint8) * cpool->capacity);
64 cpool->data = ggc_realloc (cpool->data,
65 sizeof(union cpool_entry) * cpool->capacity);
67 /* Make sure GC never sees uninitialized tag values. */
68 memset (cpool->tags + old_cap, 0, cpool->capacity - old_cap);
69 memset (cpool->data + old_cap, 0,
70 (cpool->capacity - old_cap) * sizeof (union cpool_entry));
72 if (index >= cpool->count)
73 cpool->count = index + 1;
74 cpool->tags[index] = tag;
75 cpool->data[index].w = value;
78 /* Find (or create) a constant pool entry matching TAG and VALUE. */
80 int
81 find_constant1 (CPool *cpool, int tag, jword value)
83 int i;
84 for (i = cpool->count; --i > 0; )
86 if (cpool->tags[i] == tag && cpool->data[i].w == value)
87 return i;
89 i = cpool->count == 0 ? 1 : cpool->count;
90 set_constant_entry (cpool, i, tag, value);
91 return i;
94 /* Find a double-word constant pool entry matching TAG and WORD1/WORD2. */
96 int
97 find_constant2 (CPool *cpool, int tag, jword word1, jword word2)
99 int i;
100 for (i = cpool->count - 1; --i > 0; )
102 if (cpool->tags[i] == tag
103 && cpool->data[i].w == word1
104 && cpool->data[i+1].w == word2)
105 return i;
107 i = cpool->count == 0 ? 1 : cpool->count;
108 set_constant_entry (cpool, i, tag, word1);
109 set_constant_entry (cpool, i+1, 0, word2);
110 return i;
113 static int
114 find_tree_constant (CPool *cpool, int tag, tree value)
116 int i;
117 for (i = cpool->count; --i > 0; )
119 if (cpool->tags[i] == tag && cpool->data[i].t == value)
120 return i;
122 i = cpool->count == 0 ? 1 : cpool->count;
123 set_constant_entry (cpool, i, tag, 0);
124 cpool->data[i].t = value;
125 return i;
130 find_utf8_constant (CPool *cpool, tree name)
132 if (name == NULL_TREE)
133 return 0;
134 return find_tree_constant (cpool, CONSTANT_Utf8, name);
137 static int
138 find_class_or_string_constant (CPool *cpool, int tag, tree name)
140 jword j = find_utf8_constant (cpool, name);
141 int i;
142 for (i = cpool->count; --i > 0; )
144 if (cpool->tags[i] == tag && cpool->data[i].w == j)
145 return i;
147 i = cpool->count;
148 set_constant_entry (cpool, i, tag, j);
149 return i;
153 find_class_constant (CPool *cpool, tree type)
155 return find_class_or_string_constant (cpool, CONSTANT_Class,
156 build_internal_class_name (type));
159 /* Allocate a CONSTANT_string entry given a STRING_CST. */
162 find_string_constant (CPool *cpool, tree string)
164 string = get_identifier (TREE_STRING_POINTER (string));
165 return find_class_or_string_constant (cpool, CONSTANT_String, string);
169 /* Find (or create) a CONSTANT_NameAndType matching NAME and TYPE.
170 Return its index in the constant pool CPOOL. */
172 static int
173 find_name_and_type_constant (CPool *cpool, tree name, tree type)
175 int name_index = find_utf8_constant (cpool, name);
176 int type_index = find_utf8_constant (cpool, build_java_signature (type));
177 return find_constant1 (cpool, CONSTANT_NameAndType,
178 (name_index << 16) | type_index);
181 /* Find (or create) a CONSTANT_Fieldref for DECL (a FIELD_DECL or VAR_DECL).
182 Return its index in the constant pool CPOOL. */
185 find_fieldref_index (CPool *cpool, tree decl)
187 int class_index = find_class_constant (cpool, DECL_CONTEXT (decl));
188 int name_type_index
189 = find_name_and_type_constant (cpool, DECL_NAME (decl), TREE_TYPE (decl));
190 return find_constant1 (cpool, CONSTANT_Fieldref,
191 (class_index << 16) | name_type_index);
194 /* Find (or create) a CONSTANT_Methodref for DECL (a FUNCTION_DECL).
195 Return its index in the constant pool CPOOL. */
198 find_methodref_index (CPool *cpool, tree decl)
200 return find_methodref_with_class_index (cpool, decl, DECL_CONTEXT (decl));
204 find_methodref_with_class_index (CPool *cpool, tree decl, tree mclass)
206 int class_index = find_class_constant (cpool, mclass);
207 tree name = DECL_CONSTRUCTOR_P (decl) ? init_identifier_node
208 : DECL_NAME (decl);
209 int name_type_index;
210 name_type_index =
211 find_name_and_type_constant (cpool, name, TREE_TYPE (decl));
212 return find_constant1 (cpool,
213 CLASS_INTERFACE (TYPE_NAME (mclass))
214 ? CONSTANT_InterfaceMethodref
215 : CONSTANT_Methodref,
216 (class_index << 16) | name_type_index);
219 #define PUT1(X) (*ptr++ = (X))
220 #define PUT2(X) (PUT1((X) >> 8), PUT1(X))
221 #define PUT4(X) (PUT2((X) >> 16), PUT2(X))
222 #define PUTN(P, N) (memcpy(ptr, (P), (N)), ptr += (N))
224 /* Give the number of bytes needed in a .class file for the CPOOL
225 constant pool. Includes the 2-byte constant_pool_count. */
228 count_constant_pool_bytes (CPool *cpool)
230 int size = 2;
231 int i = 1;
232 for ( ; i < cpool->count; i++)
234 size++;
235 switch (cpool->tags[i])
237 case CONSTANT_NameAndType:
238 case CONSTANT_Fieldref:
239 case CONSTANT_Methodref:
240 case CONSTANT_InterfaceMethodref:
241 case CONSTANT_Float:
242 case CONSTANT_Integer:
243 size += 4;
244 break;
245 case CONSTANT_Class:
246 case CONSTANT_String:
247 size += 2;
248 break;
249 case CONSTANT_Long:
250 case CONSTANT_Double:
251 size += 8;
252 i++;
253 break;
254 case CONSTANT_Utf8:
256 tree t = cpool->data[i].t;
257 int len = IDENTIFIER_LENGTH (t);
258 size += len + 2;
260 break;
261 default:
262 /* Second word of CONSTANT_Long and CONSTANT_Double. */
263 size--;
266 return size;
269 /* Write the constant pool CPOOL into BUFFER.
270 The length of BUFFER is LENGTH, which must match the needed length. */
272 void
273 write_constant_pool (CPool *cpool, unsigned char *buffer, int length)
275 unsigned char *ptr = buffer;
276 int i = 1;
277 union cpool_entry *datap = &cpool->data[1];
278 PUT2 (cpool->count);
279 for ( ; i < cpool->count; i++, datap++)
281 int tag = cpool->tags[i];
282 PUT1 (tag);
283 switch (tag)
285 case CONSTANT_NameAndType:
286 case CONSTANT_Fieldref:
287 case CONSTANT_Methodref:
288 case CONSTANT_InterfaceMethodref:
289 case CONSTANT_Float:
290 case CONSTANT_Integer:
291 PUT4 (datap->w);
292 break;
293 case CONSTANT_Class:
294 case CONSTANT_String:
295 PUT2 (datap->w);
296 break;
297 break;
298 case CONSTANT_Long:
299 case CONSTANT_Double:
300 PUT4(datap->w);
301 i++;
302 datap++;
303 PUT4 (datap->w);
304 break;
305 case CONSTANT_Utf8:
307 tree t = datap->t;
308 int len = IDENTIFIER_LENGTH (t);
309 PUT2 (len);
310 PUTN (IDENTIFIER_POINTER (t), len);
312 break;
316 gcc_assert (ptr == buffer + length);
319 static GTY(()) tree tag_nodes[13];
320 static tree
321 get_tag_node (int tag)
323 /* A Cache for build_int_cst (CONSTANT_XXX, 0). */
325 if (tag_nodes[tag] == NULL_TREE)
326 tag_nodes[tag] = build_int_cst (NULL_TREE, tag);
327 return tag_nodes[tag];
330 /* Given a class, return its constant pool, creating one if necessary. */
332 static CPool *
333 cpool_for_class (tree class)
335 CPool *cpool = TYPE_CPOOL (class);
337 if (cpool == NULL)
339 cpool = ggc_alloc_cleared (sizeof (struct CPool));
340 TYPE_CPOOL (class) = cpool;
342 return cpool;
345 /* Look for a constant pool entry that matches TAG and NAME.
346 Creates a new entry if not found.
347 TAG is one of CONSTANT_Utf8, CONSTANT_String or CONSTANT_Class.
348 NAME is an IDENTIFIER_NODE naming the Utf8 constant, string, or class.
349 Returns the index of the entry. */
352 alloc_name_constant (int tag, tree name)
354 CPool *outgoing_cpool = cpool_for_class (output_class);
355 return find_tree_constant (outgoing_cpool, tag, name);
358 /* Create a constant pool entry for a name_and_type. This one has '.'
359 rather than '/' because it isn't going into a class file, it's
360 going into a compiled object. We don't use the '/' separator in
361 compiled objects. */
363 static int
364 find_name_and_type_constant_tree (CPool *cpool, tree name, tree type)
366 int name_index = find_utf8_constant (cpool, name);
367 int type_index
368 = find_utf8_constant (cpool,
369 identifier_subst (build_java_signature (type),
370 "", '/', '.', ""));
371 return find_constant1 (cpool, CONSTANT_NameAndType,
372 (name_index << 16) | type_index);
375 /* Look for a field ref that matches DECL in the constant pool of
376 CLASS.
377 Return the index of the entry. */
380 alloc_constant_fieldref (tree class, tree decl)
382 CPool *outgoing_cpool = cpool_for_class (class);
383 int class_index
384 = find_tree_constant (outgoing_cpool, CONSTANT_Class,
385 DECL_NAME (TYPE_NAME (DECL_CONTEXT (decl))));
386 int name_type_index
387 = find_name_and_type_constant_tree (outgoing_cpool, DECL_NAME (decl),
388 TREE_TYPE (decl));
389 return find_constant1 (outgoing_cpool, CONSTANT_Fieldref,
390 (class_index << 16) | name_type_index);
393 /* Build an identifier for the internal name of reference type TYPE. */
395 tree
396 build_internal_class_name (tree type)
398 tree name;
399 if (TYPE_ARRAY_P (type))
400 name = build_java_signature (type);
401 else
403 name = TYPE_NAME (type);
404 if (TREE_CODE (name) != IDENTIFIER_NODE)
405 name = DECL_NAME (name);
406 name = identifier_subst (name, "", '.', '/', "");
408 return name;
411 /* Look for a CONSTANT_Class entry for CLAS, creating a new one if needed. */
414 alloc_class_constant (tree clas)
416 tree class_name = build_internal_class_name (clas);
418 return alloc_name_constant (CONSTANT_Class,
419 (unmangle_classname
420 (IDENTIFIER_POINTER(class_name),
421 IDENTIFIER_LENGTH(class_name))));
424 /* Return the decl of the data array of the current constant pool. */
426 static tree
427 build_constant_data_ref (void)
429 tree decl = TYPE_CPOOL_DATA_REF (output_class);
431 if (decl == NULL_TREE)
433 tree type;
434 tree decl_name = mangled_classname ("_CD_", output_class);
436 /* Build a type with unspecified bounds. The will make sure
437 that targets do the right thing with whatever size we end
438 up with at the end. Using bounds that are too small risks
439 assuming the data is in the small data section. */
440 type = build_array_type (ptr_type_node, NULL_TREE);
442 /* We need to lay out the type ourselves, since build_array_type
443 thinks the type is incomplete. */
444 layout_type (type);
446 decl = build_decl (VAR_DECL, decl_name, type);
447 TREE_STATIC (decl) = 1;
448 TYPE_CPOOL_DATA_REF (output_class) = decl;
451 return decl;
454 /* Get the pointer value at the INDEX'th element of the constant pool. */
456 tree
457 build_ref_from_constant_pool (int index)
459 tree d = build_constant_data_ref ();
460 tree i = build_int_cst (NULL_TREE, index);
461 return build4 (ARRAY_REF, TREE_TYPE (TREE_TYPE (d)), d, i,
462 NULL_TREE, NULL_TREE);
465 /* Build an initializer for the constants field of the current constant pool.
466 Should only be called at top-level, since it may emit declarations. */
468 tree
469 build_constants_constructor (void)
471 CPool *outgoing_cpool = cpool_for_class (current_class);
472 tree tags_value, data_value;
473 tree cons;
474 tree tags_list = NULL_TREE;
475 tree data_list = NULL_TREE;
476 int i;
477 for (i = outgoing_cpool->count; --i > 0; )
478 switch (outgoing_cpool->tags[i])
480 case CONSTANT_Fieldref:
481 case CONSTANT_NameAndType:
483 unsigned HOST_WIDE_INT temp = outgoing_cpool->data[i].w;
485 /* Make sure that on a 64-bit big-endian machine this
486 32-bit jint appears in the first word.
487 FIXME: This is a kludge. The field we're initializing is
488 not a scalar but a union, and that's how we should
489 represent it in the compiler. We should fix this. */
490 if (BYTES_BIG_ENDIAN && BITS_PER_WORD > 32)
491 temp <<= BITS_PER_WORD - 32;
493 tags_list
494 = tree_cons (NULL_TREE,
495 build_int_cst (NULL_TREE, outgoing_cpool->tags[i]),
496 tags_list);
497 data_list
498 = tree_cons (NULL_TREE,
499 fold_convert (ptr_type_node,
500 (build_int_cst (NULL_TREE, temp))),
501 data_list);
503 break;
504 default:
505 tags_list
506 = tree_cons (NULL_TREE, get_tag_node (outgoing_cpool->tags[i]),
507 tags_list);
508 data_list
509 = tree_cons (NULL_TREE, build_utf8_ref (outgoing_cpool->data[i].t),
510 data_list);
511 break;
513 if (outgoing_cpool->count > 0)
515 tree data_decl, tags_decl, tags_type;
516 tree max_index = build_int_cst (sizetype, outgoing_cpool->count - 1);
517 tree index_type = build_index_type (max_index);
519 /* Add dummy 0'th element of constant pool. */
520 tags_list = tree_cons (NULL_TREE, get_tag_node (0), tags_list);
521 data_list = tree_cons (NULL_TREE, null_pointer_node, data_list);
523 data_decl = build_constant_data_ref ();
524 TREE_TYPE (data_decl) = build_array_type (ptr_type_node, index_type);
525 DECL_INITIAL (data_decl) = build_constructor_from_list
526 (TREE_TYPE (data_decl), data_list);
527 DECL_SIZE (data_decl) = TYPE_SIZE (TREE_TYPE (data_decl));
528 DECL_SIZE_UNIT (data_decl) = TYPE_SIZE_UNIT (TREE_TYPE (data_decl));
529 rest_of_decl_compilation (data_decl, 1, 0);
530 data_value = build_address_of (data_decl);
532 tags_type = build_array_type (unsigned_byte_type_node, index_type);
533 tags_decl = build_decl (VAR_DECL, mangled_classname ("_CT_",
534 current_class),
535 tags_type);
536 TREE_STATIC (tags_decl) = 1;
537 DECL_INITIAL (tags_decl) = build_constructor_from_list
538 (tags_type, tags_list);
539 rest_of_decl_compilation (tags_decl, 1, 0);
540 tags_value = build_address_of (tags_decl);
542 else
544 data_value = null_pointer_node;
545 tags_value = null_pointer_node;
547 START_RECORD_CONSTRUCTOR (cons, constants_type_node);
548 PUSH_FIELD_VALUE (cons, "size",
549 build_int_cst (NULL_TREE, outgoing_cpool->count));
550 PUSH_FIELD_VALUE (cons, "tags", tags_value);
551 PUSH_FIELD_VALUE (cons, "data", data_value);
552 FINISH_RECORD_CONSTRUCTOR (cons);
553 return cons;
556 #include "gt-java-constants.h"