truffle: src/share/vm/oops/symbol.hpp annotate

annotate src/share/vm/oops/symbol.hpp @ 3917:eca1193ca245

4965777: GC changes to support use of discovered field for pending references Summary: If and when the reference handler thread is able to use the discovered field to link reference objects in its pending list, so will GC. In that case, GC will scan through this field once a reference object has been placed on the pending list, but not scan that field before that stage, as the field is used by the concurrent GC thread to link discovered objects. When ReferenceHandleR thread does not use the discovered field for the purpose of linking the elements in the pending list, as would be the case in older JDKs, the JVM will fall back to the old behaviour of using the next field for that purpose. Reviewed-by: jcoomes, mchung, stefank

author	ysr
date	Wed, 07 Sep 2011 13:55:42 -0700
parents	1d1603768966
children	fc9d8850ab8b

rev	line source
0 a61af66fc99e Initial load duke parents: diff changeset	1 /*
2426 1d1603768966 7010070: Update all 2010 Oracle-changed OpenJDK files to have the proper copyright dates - second pass trims parents: 2177 diff changeset	2 * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
0 a61af66fc99e Initial load duke parents: diff changeset	3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
a61af66fc99e Initial load duke parents: diff changeset	4 *
a61af66fc99e Initial load duke parents: diff changeset	5 * This code is free software; you can redistribute it and/or modify it
a61af66fc99e Initial load duke parents: diff changeset	6 * under the terms of the GNU General Public License version 2 only, as
a61af66fc99e Initial load duke parents: diff changeset	7 * published by the Free Software Foundation.
a61af66fc99e Initial load duke parents: diff changeset	8 *
a61af66fc99e Initial load duke parents: diff changeset	9 * This code is distributed in the hope that it will be useful, but WITHOUT
a61af66fc99e Initial load duke parents: diff changeset	10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
a61af66fc99e Initial load duke parents: diff changeset	11 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
a61af66fc99e Initial load duke parents: diff changeset	12 * version 2 for more details (a copy is included in the LICENSE file that
a61af66fc99e Initial load duke parents: diff changeset	13 * accompanied this code).
a61af66fc99e Initial load duke parents: diff changeset	14 *
a61af66fc99e Initial load duke parents: diff changeset	15 * You should have received a copy of the GNU General Public License version
a61af66fc99e Initial load duke parents: diff changeset	16 * 2 along with this work; if not, write to the Free Software Foundation,
a61af66fc99e Initial load duke parents: diff changeset	17 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
a61af66fc99e Initial load duke parents: diff changeset	18 *
1552 c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories trims parents: 1138 diff changeset	19 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories trims parents: 1138 diff changeset	20 * or visit www.oracle.com if you need additional information or have any
c18cbe5936b8 6941466: Oracle rebranding changes for Hotspot repositories trims parents: 1138 diff changeset	21 * questions.
0 a61af66fc99e Initial load duke parents: diff changeset	22 *
a61af66fc99e Initial load duke parents: diff changeset	23 */
a61af66fc99e Initial load duke parents: diff changeset	24
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	25 #ifndef SHARE_VM_OOPS_SYMBOL_HPP
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	26 #define SHARE_VM_OOPS_SYMBOL_HPP
1972 f95d63e2154a 6989984: Use standard include model for Hospot stefank parents: 1552 diff changeset	27
f95d63e2154a 6989984: Use standard include model for Hospot stefank parents: 1552 diff changeset	28 #include "utilities/utf8.hpp"
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	29 #include "memory/allocation.hpp"
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	30
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	31 // A Symbol is a canonicalized string.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	32 // All Symbols reside in global SymbolTable and are reference counted.
1972 f95d63e2154a 6989984: Use standard include model for Hospot stefank parents: 1552 diff changeset	33
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	34 // Reference counting
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	35 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	36 // All Symbols are allocated and added to the SymbolTable.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	37 // When a class is unloaded, the reference counts of the Symbol pointers in
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	38 // the ConstantPool and in instanceKlass (see release_C_heap_structures) are
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	39 // decremented. When the reference count for a Symbol goes to 0, the garbage
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	40 // collector can free the Symbol and remove it from the SymbolTable.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	41 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	42 // 0) Symbols need to be reference counted when a pointer to the Symbol is
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	43 // saved in persistent storage. This does not include the pointer
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	44 // in the SymbolTable bucket (the _literal field in HashtableEntry)
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	45 // that points to the Symbol. All other stores of a Symbol*
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	46 // to a field of a persistent variable (e.g., the _name filed in
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	47 // FieldAccessInfo or _ptr in a CPSlot) is reference counted.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	48 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	49 // 1) The lookup of a "name" in the SymbolTable either creates a Symbol F for
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	50 // "name" and returns a pointer to F or finds a pre-existing Symbol F for
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	51 // "name" and returns a pointer to it. In both cases the reference count for F
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	52 // is incremented under the assumption that a pointer to F will be created from
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	53 // the return value. Thus the increment of the reference count is on the lookup
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	54 // and not on the assignment to the new Symbol*. That is
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	55 // Symbol* G = lookup()
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	56 // ^ increment on lookup()
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	57 // and not
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	58 // Symbol* G = lookup()
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	59 // ^ increment on assignmnet
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	60 // The reference count must be decremented manually when the copy of the
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	61 // pointer G is destroyed.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	62 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	63 // 2) For a local Symbol* A that is a copy of an existing Symbol* B, the
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	64 // reference counting is elided when the scope of B is greater than the scope
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	65 // of A. For example, in the code fragment
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	66 // below "klass" is passed as a parameter to the method. Symbol* "kn"
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	67 // is a copy of the name in "klass".
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	68 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	69 // Symbol* kn = klass->name();
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	70 // unsigned int d_hash = dictionary()->compute_hash(kn, class_loader);
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	71 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	72 // The scope of "klass" is greater than the scope of "kn" so the reference
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	73 // counting for "kn" is elided.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	74 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	75 // Symbol* copied from ConstantPool entries are good candidates for reference
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	76 // counting elision. The ConstantPool entries for a class C exist until C is
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	77 // unloaded. If a Symbol* is copied out of the ConstantPool into Symbol* X,
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	78 // the Symbol* in the ConstantPool will in general out live X so the reference
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	79 // counting on X can be elided.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	80 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	81 // For cases where the scope of A is not greater than the scope of B,
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	82 // the reference counting is explicitly done. See ciSymbol,
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	83 // ResolutionErrorEntry and ClassVerifier for examples.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	84 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	85 // 3) When a Symbol K is created for temporary use, generally for substrings of
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	86 // an existing symbol or to create a new symbol, assign it to a
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	87 // TempNewSymbol. The SymbolTable methods new_symbol(), lookup()
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	88 // and probe() all potentially return a pointer to a new Symbol.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	89 // The allocation (or lookup) of K increments the reference count for K
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	90 // and the destructor decrements the reference count.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	91 //
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	92 // Another example of TempNewSymbol usage is parsed_name used in
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	93 // ClassFileParser::parseClassFile() where parsed_name is used in the cleanup
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	94 // after a failed attempt to load a class. Here parsed_name is a
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	95 // TempNewSymbol (passed in as a parameter) so the reference count on its symbol
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	96 // will be decremented when it goes out of scope.
0 a61af66fc99e Initial load duke parents: diff changeset	97
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	98 class Symbol : public CHeapObj {
0 a61af66fc99e Initial load duke parents: diff changeset	99 friend class VMStructs;
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	100 friend class SymbolTable;
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	101 friend class MoveSymbols;
0 a61af66fc99e Initial load duke parents: diff changeset	102 private:
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	103 volatile int _refcount;
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	104 int _identity_hash;
0 a61af66fc99e Initial load duke parents: diff changeset	105 unsigned short _length; // number of UTF8 characters in the symbol
a61af66fc99e Initial load duke parents: diff changeset	106 jbyte _body[1];
a61af66fc99e Initial load duke parents: diff changeset	107
a61af66fc99e Initial load duke parents: diff changeset	108 enum {
a61af66fc99e Initial load duke parents: diff changeset	109 // max_symbol_length is constrained by type of _length
a61af66fc99e Initial load duke parents: diff changeset	110 max_symbol_length = (1 << 16) -1
a61af66fc99e Initial load duke parents: diff changeset	111 };
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	112
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	113 static int object_size(int length) {
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	114 size_t size = heap_word_size(sizeof(Symbol) + length);
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	115 return align_object_size(size);
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	116 }
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	117
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	118 void byte_at_put(int index, int value) {
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	119 assert(index >=0 && index < _length, "symbol index overflow");
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	120 _body[index] = value;
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	121 }
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	122
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	123 Symbol(const u1* name, int length);
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	124 void* operator new(size_t size, int len);
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	125
0 a61af66fc99e Initial load duke parents: diff changeset	126 public:
a61af66fc99e Initial load duke parents: diff changeset	127 // Low-level access (used with care, since not GC-safe)
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	128 const jbyte* base() const { return &_body[0]; }
0 a61af66fc99e Initial load duke parents: diff changeset	129
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	130 int object_size() { return object_size(utf8_length()); }
0 a61af66fc99e Initial load duke parents: diff changeset	131
a61af66fc99e Initial load duke parents: diff changeset	132 // Returns the largest size symbol we can safely hold.
a61af66fc99e Initial load duke parents: diff changeset	133 static int max_length() {
a61af66fc99e Initial load duke parents: diff changeset	134 return max_symbol_length;
a61af66fc99e Initial load duke parents: diff changeset	135 }
a61af66fc99e Initial load duke parents: diff changeset	136
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	137 int identity_hash() {
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	138 return _identity_hash;
0 a61af66fc99e Initial load duke parents: diff changeset	139 }
a61af66fc99e Initial load duke parents: diff changeset	140
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	141 // Reference counting. See comments above this class for when to use.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	142 int refcount() const { return _refcount; }
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	143 void increment_refcount();
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	144 void decrement_refcount();
0 a61af66fc99e Initial load duke parents: diff changeset	145
a61af66fc99e Initial load duke parents: diff changeset	146 int byte_at(int index) const {
a61af66fc99e Initial load duke parents: diff changeset	147 assert(index >=0 && index < _length, "symbol index overflow");
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	148 return base()[index];
0 a61af66fc99e Initial load duke parents: diff changeset	149 }
a61af66fc99e Initial load duke parents: diff changeset	150
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	151 const jbyte* bytes() const { return base(); }
0 a61af66fc99e Initial load duke parents: diff changeset	152
a61af66fc99e Initial load duke parents: diff changeset	153 int utf8_length() const { return _length; }
a61af66fc99e Initial load duke parents: diff changeset	154
1138 dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	155 // Compares the symbol with a string.
0 a61af66fc99e Initial load duke parents: diff changeset	156 bool equals(const char* str, int len) const;
1138 dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	157 bool equals(const char* str) const { return equals(str, (int) strlen(str)); }
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	158
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	159 // Tests if the symbol starts with the given prefix.
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	160 bool starts_with(const char* prefix, int len) const;
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	161 bool starts_with(const char* prefix) const {
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	162 return starts_with(prefix, (int) strlen(prefix));
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	163 }
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	164
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	165 // Tests if the symbol starts with the given prefix.
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	166 int index_of_at(int i, const char* str, int len) const;
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	167 int index_of_at(int i, const char* str) const {
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	168 return index_of_at(i, str, (int) strlen(str));
dd57230ba8fe 6893268: additional dynamic language related optimizations in C2 twisti parents: 0 diff changeset	169 }
0 a61af66fc99e Initial load duke parents: diff changeset	170
a61af66fc99e Initial load duke parents: diff changeset	171 // Three-way compare for sorting; returns -1/0/1 if receiver is </==/> than arg
a61af66fc99e Initial load duke parents: diff changeset	172 // note that the ordering is not alfabetical
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	173 inline int fast_compare(Symbol* other) const;
0 a61af66fc99e Initial load duke parents: diff changeset	174
a61af66fc99e Initial load duke parents: diff changeset	175 // Returns receiver converted to null-terminated UTF-8 string; string is
a61af66fc99e Initial load duke parents: diff changeset	176 // allocated in resource area, or in the char buffer provided by caller.
a61af66fc99e Initial load duke parents: diff changeset	177 char* as_C_string() const;
a61af66fc99e Initial load duke parents: diff changeset	178 char* as_C_string(char* buf, int size) const;
a61af66fc99e Initial load duke parents: diff changeset	179 // Use buf if needed buffer length is <= size.
a61af66fc99e Initial load duke parents: diff changeset	180 char* as_C_string_flexible_buffer(Thread* t, char* buf, int size) const;
a61af66fc99e Initial load duke parents: diff changeset	181
a61af66fc99e Initial load duke parents: diff changeset	182
a61af66fc99e Initial load duke parents: diff changeset	183 // Returns a null terminated utf8 string in a resource array
a61af66fc99e Initial load duke parents: diff changeset	184 char* as_utf8() const { return as_C_string(); }
a61af66fc99e Initial load duke parents: diff changeset	185 char* as_utf8_flexible_buffer(Thread* t, char* buf, int size) const {
a61af66fc99e Initial load duke parents: diff changeset	186 return as_C_string_flexible_buffer(t, buf, size);
a61af66fc99e Initial load duke parents: diff changeset	187 }
a61af66fc99e Initial load duke parents: diff changeset	188
a61af66fc99e Initial load duke parents: diff changeset	189 jchar* as_unicode(int& length) const;
a61af66fc99e Initial load duke parents: diff changeset	190
a61af66fc99e Initial load duke parents: diff changeset	191 // Treating this symbol as a class name, returns the Java name for the class.
a61af66fc99e Initial load duke parents: diff changeset	192 // String is allocated in resource area if buffer is not provided.
a61af66fc99e Initial load duke parents: diff changeset	193 // See Klass::external_name()
a61af66fc99e Initial load duke parents: diff changeset	194 const char* as_klass_external_name() const;
a61af66fc99e Initial load duke parents: diff changeset	195 const char* as_klass_external_name(char* buf, int size) const;
a61af66fc99e Initial load duke parents: diff changeset	196
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	197 // Printing
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	198 void print_symbol_on(outputStream* st = NULL) const;
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	199 void print_on(outputStream* st) const; // First level print
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	200 void print_value_on(outputStream* st) const; // Second level print.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	201
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	202 // printing on default output stream
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	203 void print() { print_on(tty); }
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	204 void print_value() { print_value_on(tty); }
0 a61af66fc99e Initial load duke parents: diff changeset	205
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	206 #ifndef PRODUCT
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	207 // Empty constructor to create a dummy symbol object on stack
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	208 // only for getting its vtable pointer.
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	209 Symbol() { }
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	210
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	211 static int _total_count;
3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	212 #endif
0 a61af66fc99e Initial load duke parents: diff changeset	213 };
a61af66fc99e Initial load duke parents: diff changeset	214
a61af66fc99e Initial load duke parents: diff changeset	215 // Note: this comparison is used for vtable sorting only; it doesn't matter
a61af66fc99e Initial load duke parents: diff changeset	216 // what order it defines, as long as it is a total, time-invariant order
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	217 // Since Symbol*s are in C_HEAP, their relative order in memory never changes,
0 a61af66fc99e Initial load duke parents: diff changeset	218 // so use address comparison for speed
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	219 int Symbol::fast_compare(Symbol* other) const {
0 a61af66fc99e Initial load duke parents: diff changeset	220 return (((uintptr_t)this < (uintptr_t)other) ? -1
a61af66fc99e Initial load duke parents: diff changeset	221 : ((uintptr_t)this == (uintptr_t) other) ? 0 : 1);
a61af66fc99e Initial load duke parents: diff changeset	222 }
2177 3582bf76420e 6990754: Use native memory and reference counting to implement SymbolTable coleenp parents: 1972 diff changeset	223 #endif // SHARE_VM_OOPS_SYMBOL_HPP

Mercurial > hg > truffle

annotate src/share/vm/oops/symbol.hpp @ 3917:eca1193ca245