annotate src/share/vm/libadt/set.cpp @ 605:98cb887364d3

6810672: Comment typos Summary: I have collected some typos I have found while looking at the code. Reviewed-by: kvn, never
author twisti
date Fri, 27 Feb 2009 13:27:09 -0800
parents a61af66fc99e
children c18cbe5936b8
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
a61af66fc99e Initial load
duke
parents:
diff changeset
1 /*
a61af66fc99e Initial load
duke
parents:
diff changeset
2 * Copyright 1997-2006 Sun Microsystems, Inc. All Rights Reserved.
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 *
a61af66fc99e Initial load
duke
parents:
diff changeset
19 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
a61af66fc99e Initial load
duke
parents:
diff changeset
20 * CA 95054 USA or visit www.sun.com if you need additional information or
a61af66fc99e Initial load
duke
parents:
diff changeset
21 * have any questions.
a61af66fc99e Initial load
duke
parents:
diff changeset
22 *
a61af66fc99e Initial load
duke
parents:
diff changeset
23 */
a61af66fc99e Initial load
duke
parents:
diff changeset
24
a61af66fc99e Initial load
duke
parents:
diff changeset
25 // Sets - An Abstract Data Type
a61af66fc99e Initial load
duke
parents:
diff changeset
26
a61af66fc99e Initial load
duke
parents:
diff changeset
27 #include "incls/_precompiled.incl"
a61af66fc99e Initial load
duke
parents:
diff changeset
28 #include "incls/_set.cpp.incl"
a61af66fc99e Initial load
duke
parents:
diff changeset
29
a61af66fc99e Initial load
duke
parents:
diff changeset
30 // %%%%% includes not needed with AVM framework - Ungar
a61af66fc99e Initial load
duke
parents:
diff changeset
31 // #include "port.hpp"
a61af66fc99e Initial load
duke
parents:
diff changeset
32 //IMPLEMENTATION
a61af66fc99e Initial load
duke
parents:
diff changeset
33 // #include "set.hpp"
a61af66fc99e Initial load
duke
parents:
diff changeset
34
a61af66fc99e Initial load
duke
parents:
diff changeset
35 #include <stdio.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
36 #include <assert.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
37 #include <string.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
38 #include <stdlib.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
39
a61af66fc99e Initial load
duke
parents:
diff changeset
40 // Not needed and it causes terouble for gcc.
a61af66fc99e Initial load
duke
parents:
diff changeset
41 //
a61af66fc99e Initial load
duke
parents:
diff changeset
42 // #include <iostream.h>
a61af66fc99e Initial load
duke
parents:
diff changeset
43
a61af66fc99e Initial load
duke
parents:
diff changeset
44 //-------------------------Virtual Functions-----------------------------------
a61af66fc99e Initial load
duke
parents:
diff changeset
45 // These functions MUST be implemented by the inheriting class.
a61af66fc99e Initial load
duke
parents:
diff changeset
46 class SparseSet;
a61af66fc99e Initial load
duke
parents:
diff changeset
47 /* Removed for MCC BUG
a61af66fc99e Initial load
duke
parents:
diff changeset
48 Set::operator const SparseSet*() const { assert(0); return NULL; } */
a61af66fc99e Initial load
duke
parents:
diff changeset
49 const SparseSet *Set::asSparseSet() const { assert(0); return NULL; }
a61af66fc99e Initial load
duke
parents:
diff changeset
50 class VectorSet;
a61af66fc99e Initial load
duke
parents:
diff changeset
51 /* Removed for MCC BUG
a61af66fc99e Initial load
duke
parents:
diff changeset
52 Set::operator const VectorSet*() const { assert(0); return NULL; } */
a61af66fc99e Initial load
duke
parents:
diff changeset
53 const VectorSet *Set::asVectorSet() const { assert(0); return NULL; }
a61af66fc99e Initial load
duke
parents:
diff changeset
54 class ListSet;
a61af66fc99e Initial load
duke
parents:
diff changeset
55 /* Removed for MCC BUG
a61af66fc99e Initial load
duke
parents:
diff changeset
56 Set::operator const ListSet*() const { assert(0); return NULL; } */
a61af66fc99e Initial load
duke
parents:
diff changeset
57 const ListSet *Set::asListSet() const { assert(0); return NULL; }
a61af66fc99e Initial load
duke
parents:
diff changeset
58 class CoSet;
a61af66fc99e Initial load
duke
parents:
diff changeset
59 /* Removed for MCC BUG
a61af66fc99e Initial load
duke
parents:
diff changeset
60 Set::operator const CoSet*() const { assert(0); return NULL; } */
a61af66fc99e Initial load
duke
parents:
diff changeset
61 const CoSet *Set::asCoSet() const { assert(0); return NULL; }
a61af66fc99e Initial load
duke
parents:
diff changeset
62
a61af66fc99e Initial load
duke
parents:
diff changeset
63 //------------------------------setstr-----------------------------------------
a61af66fc99e Initial load
duke
parents:
diff changeset
64 // Create a string with a printable representation of a set.
a61af66fc99e Initial load
duke
parents:
diff changeset
65 // The caller must deallocate the string.
a61af66fc99e Initial load
duke
parents:
diff changeset
66 char *Set::setstr() const
a61af66fc99e Initial load
duke
parents:
diff changeset
67 {
a61af66fc99e Initial load
duke
parents:
diff changeset
68 if( !this ) return os::strdup("{no set}");
a61af66fc99e Initial load
duke
parents:
diff changeset
69 Set &set = clone(); // Virtually copy the basic set.
a61af66fc99e Initial load
duke
parents:
diff changeset
70 set.Sort(); // Sort elements for in-order retrieval
a61af66fc99e Initial load
duke
parents:
diff changeset
71
a61af66fc99e Initial load
duke
parents:
diff changeset
72 uint len = 128; // Total string space
a61af66fc99e Initial load
duke
parents:
diff changeset
73 char *buf = NEW_C_HEAP_ARRAY(char,len);// Some initial string space
a61af66fc99e Initial load
duke
parents:
diff changeset
74
a61af66fc99e Initial load
duke
parents:
diff changeset
75 register char *s = buf; // Current working string pointer
a61af66fc99e Initial load
duke
parents:
diff changeset
76 *s++ = '{';
a61af66fc99e Initial load
duke
parents:
diff changeset
77 *s = '\0';
a61af66fc99e Initial load
duke
parents:
diff changeset
78
a61af66fc99e Initial load
duke
parents:
diff changeset
79 // For all elements of the Set
a61af66fc99e Initial load
duke
parents:
diff changeset
80 uint hi = (uint)-2, lo = (uint)-2;
a61af66fc99e Initial load
duke
parents:
diff changeset
81 for( SetI i(&set); i.test(); ++i ) {
a61af66fc99e Initial load
duke
parents:
diff changeset
82 if( hi+1 == i.elem ) { // Moving sequentially thru range?
a61af66fc99e Initial load
duke
parents:
diff changeset
83 hi = i.elem; // Yes, just update hi end of range
a61af66fc99e Initial load
duke
parents:
diff changeset
84 } else { // Else range ended
a61af66fc99e Initial load
duke
parents:
diff changeset
85 if( buf+len-s < 25 ) { // Generous trailing space for upcoming numbers
a61af66fc99e Initial load
duke
parents:
diff changeset
86 int offset = (int)(s-buf);// Not enuf space; compute offset into buffer
a61af66fc99e Initial load
duke
parents:
diff changeset
87 len <<= 1; // Double string size
a61af66fc99e Initial load
duke
parents:
diff changeset
88 buf = REALLOC_C_HEAP_ARRAY(char,buf,len); // Reallocate doubled size
a61af66fc99e Initial load
duke
parents:
diff changeset
89 s = buf+offset; // Get working pointer into new bigger buffer
a61af66fc99e Initial load
duke
parents:
diff changeset
90 }
a61af66fc99e Initial load
duke
parents:
diff changeset
91 if( lo != (uint)-2 ) { // Startup? No! Then print previous range.
a61af66fc99e Initial load
duke
parents:
diff changeset
92 if( lo != hi ) sprintf(s,"%d-%d,",lo,hi);
a61af66fc99e Initial load
duke
parents:
diff changeset
93 else sprintf(s,"%d,",lo);
a61af66fc99e Initial load
duke
parents:
diff changeset
94 s += strlen(s); // Advance working string
a61af66fc99e Initial load
duke
parents:
diff changeset
95 }
a61af66fc99e Initial load
duke
parents:
diff changeset
96 hi = lo = i.elem;
a61af66fc99e Initial load
duke
parents:
diff changeset
97 }
a61af66fc99e Initial load
duke
parents:
diff changeset
98 }
a61af66fc99e Initial load
duke
parents:
diff changeset
99 if( lo != (uint)-2 ) {
a61af66fc99e Initial load
duke
parents:
diff changeset
100 if( buf+len-s < 25 ) { // Generous trailing space for upcoming numbers
a61af66fc99e Initial load
duke
parents:
diff changeset
101 int offset = (int)(s-buf);// Not enuf space; compute offset into buffer
a61af66fc99e Initial load
duke
parents:
diff changeset
102 len <<= 1; // Double string size
a61af66fc99e Initial load
duke
parents:
diff changeset
103 buf = (char*)ReallocateHeap(buf,len); // Reallocate doubled size
a61af66fc99e Initial load
duke
parents:
diff changeset
104 s = buf+offset; // Get working pointer into new bigger buffer
a61af66fc99e Initial load
duke
parents:
diff changeset
105 }
a61af66fc99e Initial load
duke
parents:
diff changeset
106 if( lo != hi ) sprintf(s,"%d-%d}",lo,hi);
a61af66fc99e Initial load
duke
parents:
diff changeset
107 else sprintf(s,"%d}",lo);
a61af66fc99e Initial load
duke
parents:
diff changeset
108 } else strcat(s,"}");
a61af66fc99e Initial load
duke
parents:
diff changeset
109 // Don't delete the clone 'set' since it is allocated on Arena.
a61af66fc99e Initial load
duke
parents:
diff changeset
110 return buf;
a61af66fc99e Initial load
duke
parents:
diff changeset
111 }
a61af66fc99e Initial load
duke
parents:
diff changeset
112
a61af66fc99e Initial load
duke
parents:
diff changeset
113 //------------------------------print------------------------------------------
a61af66fc99e Initial load
duke
parents:
diff changeset
114 // Handier print routine
a61af66fc99e Initial load
duke
parents:
diff changeset
115 void Set::print() const
a61af66fc99e Initial load
duke
parents:
diff changeset
116 {
a61af66fc99e Initial load
duke
parents:
diff changeset
117 char *printable_set = setstr();
a61af66fc99e Initial load
duke
parents:
diff changeset
118 tty->print_cr(printable_set);
a61af66fc99e Initial load
duke
parents:
diff changeset
119 FreeHeap(printable_set);
a61af66fc99e Initial load
duke
parents:
diff changeset
120 }
a61af66fc99e Initial load
duke
parents:
diff changeset
121
a61af66fc99e Initial load
duke
parents:
diff changeset
122 //------------------------------parse------------------------------------------
a61af66fc99e Initial load
duke
parents:
diff changeset
123 // Convert a textual representation of a Set, to a Set and union into "this"
a61af66fc99e Initial load
duke
parents:
diff changeset
124 // Set. Return the amount of text parsed in "len", or zero in "len".
a61af66fc99e Initial load
duke
parents:
diff changeset
125 int Set::parse(const char *s)
a61af66fc99e Initial load
duke
parents:
diff changeset
126 {
a61af66fc99e Initial load
duke
parents:
diff changeset
127 register char c; // Parse character
a61af66fc99e Initial load
duke
parents:
diff changeset
128 register const char *t = s; // Save the starting position of s.
a61af66fc99e Initial load
duke
parents:
diff changeset
129 do c = *s++; // Skip characters
a61af66fc99e Initial load
duke
parents:
diff changeset
130 while( c && (c <= ' ') ); // Till no more whitespace or EOS
a61af66fc99e Initial load
duke
parents:
diff changeset
131 if( c != '{' ) return 0; // Oops, not a Set openner
a61af66fc99e Initial load
duke
parents:
diff changeset
132 if( *s == '}' ) return 2; // The empty Set
a61af66fc99e Initial load
duke
parents:
diff changeset
133
a61af66fc99e Initial load
duke
parents:
diff changeset
134 // Sets are filled with values of the form "xx," or "xx-yy," with the comma
a61af66fc99e Initial load
duke
parents:
diff changeset
135 // a "}" at the very end.
a61af66fc99e Initial load
duke
parents:
diff changeset
136 while( 1 ) { // While have elements in the Set
a61af66fc99e Initial load
duke
parents:
diff changeset
137 char *u; // Pointer to character ending parse
a61af66fc99e Initial load
duke
parents:
diff changeset
138 uint hi, i; // Needed for range handling below
a61af66fc99e Initial load
duke
parents:
diff changeset
139 uint elem = (uint)strtoul(s,&u,10);// Get element
a61af66fc99e Initial load
duke
parents:
diff changeset
140 if( u == s ) return 0; // Bogus crude
a61af66fc99e Initial load
duke
parents:
diff changeset
141 s = u; // Skip over the number
a61af66fc99e Initial load
duke
parents:
diff changeset
142 c = *s++; // Get the number seperator
a61af66fc99e Initial load
duke
parents:
diff changeset
143 switch ( c ) { // Different seperators
a61af66fc99e Initial load
duke
parents:
diff changeset
144 case '}': // Last simple element
a61af66fc99e Initial load
duke
parents:
diff changeset
145 case ',': // Simple element
a61af66fc99e Initial load
duke
parents:
diff changeset
146 (*this) <<= elem; // Insert the simple element into the Set
a61af66fc99e Initial load
duke
parents:
diff changeset
147 break; // Go get next element
a61af66fc99e Initial load
duke
parents:
diff changeset
148 case '-': // Range
a61af66fc99e Initial load
duke
parents:
diff changeset
149 hi = (uint)strtoul(s,&u,10); // Get element
a61af66fc99e Initial load
duke
parents:
diff changeset
150 if( u == s ) return 0; // Bogus crude
a61af66fc99e Initial load
duke
parents:
diff changeset
151 for( i=elem; i<=hi; i++ )
a61af66fc99e Initial load
duke
parents:
diff changeset
152 (*this) <<= i; // Insert the entire range into the Set
a61af66fc99e Initial load
duke
parents:
diff changeset
153 s = u; // Skip over the number
a61af66fc99e Initial load
duke
parents:
diff changeset
154 c = *s++; // Get the number seperator
a61af66fc99e Initial load
duke
parents:
diff changeset
155 break;
a61af66fc99e Initial load
duke
parents:
diff changeset
156 }
a61af66fc99e Initial load
duke
parents:
diff changeset
157 if( c == '}' ) break; // End of the Set
a61af66fc99e Initial load
duke
parents:
diff changeset
158 if( c != ',' ) return 0; // Bogus garbage
a61af66fc99e Initial load
duke
parents:
diff changeset
159 }
a61af66fc99e Initial load
duke
parents:
diff changeset
160 return (int)(s-t); // Return length parsed
a61af66fc99e Initial load
duke
parents:
diff changeset
161 }
a61af66fc99e Initial load
duke
parents:
diff changeset
162
a61af66fc99e Initial load
duke
parents:
diff changeset
163 //------------------------------Iterator---------------------------------------
a61af66fc99e Initial load
duke
parents:
diff changeset
164 SetI_::~SetI_()
a61af66fc99e Initial load
duke
parents:
diff changeset
165 {
a61af66fc99e Initial load
duke
parents:
diff changeset
166 }