OSDN Git Service

lejos_NXJ_win32_0_5_0beta.zip
[nxt-jsp/lejos_nxj.git] / nxtOSEK / lejos_nxj / docs / apidocs / java / util / Stack.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <!--NewPage-->
3 <HTML>
4 <HEAD>
5 <!-- Generated by javadoc (build 1.5.0_09) on Tue Jan 08 20:46:02 GMT 2008 -->
6 <TITLE>
7 Stack (leJOS NXT API documentation)
8 </TITLE>
9
10 <META NAME="keywords" CONTENT="java.util.Stack class">
11
12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
13
14 <SCRIPT type="text/javascript">
15 function windowTitle()
16 {
17     parent.document.title="Stack (leJOS NXT API documentation)";
18 }
19 </SCRIPT>
20 <NOSCRIPT>
21 </NOSCRIPT>
22
23 </HEAD>
24
25 <BODY BGCOLOR="white" onload="windowTitle();">
26
27
28 <!-- ========= START OF TOP NAVBAR ======= -->
29 <A NAME="navbar_top"><!-- --></A>
30 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
31 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
32 <TR>
33 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
34 <A NAME="navbar_top_firstrow"><!-- --></A>
35 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
36   <TR ALIGN="center" VALIGN="top">
37   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
38   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
39   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
40   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
41   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
42   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
43   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
44   </TR>
45 </TABLE>
46 </TD>
47 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
48 </EM>
49 </TD>
50 </TR>
51
52 <TR>
53 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
54 &nbsp;<A HREF="../../java/util/Random.html" title="class in java.util"><B>PREV CLASS</B></A>&nbsp;
55 &nbsp;<A HREF="../../java/util/Vector.html" title="class in java.util"><B>NEXT CLASS</B></A></FONT></TD>
56 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57   <A HREF="../../index.html?java/util/Stack.html" target="_top"><B>FRAMES</B></A>  &nbsp;
58 &nbsp;<A HREF="Stack.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
59 &nbsp;<SCRIPT type="text/javascript">
60   <!--
61   if(window==top) {
62     document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
63   }
64   //-->
65 </SCRIPT>
66 <NOSCRIPT>
67   <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
68 </NOSCRIPT>
69
70
71 </FONT></TD>
72 </TR>
73 <TR>
74 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
75   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.util.Vector">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
77 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
78 </TR>
79 </TABLE>
80 <A NAME="skip-navbar_top"></A>
81 <!-- ========= END OF TOP NAVBAR ========= -->
82
83 <HR>
84 <!-- ======== START OF CLASS DATA ======== -->
85 <H2>
86 <FONT SIZE="-1">
87 java.util</FONT>
88 <BR>
89 Class Stack</H2>
90 <PRE>
91 <A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>
92   <IMG SRC="../../resources/inherit.gif" ALT="extended by "><A HREF="../../java/util/Vector.html" title="class in java.util">java.util.Vector</A>
93       <IMG SRC="../../resources/inherit.gif" ALT="extended by "><B>java.util.Stack</B>
94 </PRE>
95 <HR>
96 <DL>
97 <DT><PRE>public class <B>Stack</B><DT>extends <A HREF="../../java/util/Vector.html" title="class in java.util">Vector</A></DL>
98 </PRE>
99
100 <P>
101 A LIFO stack of objects. 
102  TODO recycable
103 <P>
104
105 <P>
106 <HR>
107
108 <P>
109 <!-- =========== FIELD SUMMARY =========== -->
110
111 <A NAME="field_summary"><!-- --></A>
112 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
113 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
114 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
115 <B>Field Summary</B></FONT></TH>
116 </TR>
117 </TABLE>
118 &nbsp;<A NAME="fields_inherited_from_class_java.util.Vector"><!-- --></A>
119 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
120 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
121 <TH ALIGN="left"><B>Fields inherited from class java.util.<A HREF="../../java/util/Vector.html" title="class in java.util">Vector</A></B></TH>
122 </TR>
123 <TR BGCOLOR="white" CLASS="TableRowColor">
124 <TD><CODE><A HREF="../../java/util/Vector.html#capacityIncrement">capacityIncrement</A>, <A HREF="../../java/util/Vector.html#elementCount">elementCount</A>, <A HREF="../../java/util/Vector.html#elementData">elementData</A></CODE></TD>
125 </TR>
126 </TABLE>
127 &nbsp;
128 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
129
130 <A NAME="constructor_summary"><!-- --></A>
131 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
132 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
133 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
134 <B>Constructor Summary</B></FONT></TH>
135 </TR>
136 <TR BGCOLOR="white" CLASS="TableRowColor">
137 <TD><CODE><B><A HREF="../../java/util/Stack.html#Stack()">Stack</A></B>()</CODE>
138
139 <BR>
140 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;creates a new Stack instance</TD>
141 </TR>
142 </TABLE>
143 &nbsp;
144 <!-- ========== METHOD SUMMARY =========== -->
145
146 <A NAME="method_summary"><!-- --></A>
147 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
148 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
149 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
150 <B>Method Summary</B></FONT></TH>
151 </TR>
152 <TR BGCOLOR="white" CLASS="TableRowColor">
153 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
154 <CODE>&nbsp;boolean</CODE></FONT></TD>
155 <TD><CODE><B><A HREF="../../java/util/Stack.html#empty()">empty</A></B>()</CODE>
156
157 <BR>
158 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;is this stack empty?</TD>
159 </TR>
160 <TR BGCOLOR="white" CLASS="TableRowColor">
161 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
162 <CODE>&nbsp;<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></FONT></TD>
163 <TD><CODE><B><A HREF="../../java/util/Stack.html#peek()">peek</A></B>()</CODE>
164
165 <BR>
166 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fetches an object from the stack
167  <br>does not remove it!</TD>
168 </TR>
169 <TR BGCOLOR="white" CLASS="TableRowColor">
170 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
171 <CODE>&nbsp;<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></FONT></TD>
172 <TD><CODE><B><A HREF="../../java/util/Stack.html#pop()">pop</A></B>()</CODE>
173
174 <BR>
175 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fetches an object from the top of the stack
176  and removes it</TD>
177 </TR>
178 <TR BGCOLOR="white" CLASS="TableRowColor">
179 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
180 <CODE>&nbsp;<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></CODE></FONT></TD>
181 <TD><CODE><B><A HREF="../../java/util/Stack.html#push(java.lang.Object)">push</A></B>(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A>&nbsp;anObject)</CODE>
182
183 <BR>
184 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pushes an object onto the stack</TD>
185 </TR>
186 </TABLE>
187 &nbsp;<A NAME="methods_inherited_from_class_java.util.Vector"><!-- --></A>
188 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
189 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
190 <TH ALIGN="left"><B>Methods inherited from class java.util.<A HREF="../../java/util/Vector.html" title="class in java.util">Vector</A></B></TH>
191 </TR>
192 <TR BGCOLOR="white" CLASS="TableRowColor">
193 <TD><CODE><A HREF="../../java/util/Vector.html#addElement(java.lang.Object)">addElement</A>, <A HREF="../../java/util/Vector.html#capacity()">capacity</A>, <A HREF="../../java/util/Vector.html#clear()">clear</A>, <A HREF="../../java/util/Vector.html#elementAt(int)">elementAt</A>, <A HREF="../../java/util/Vector.html#ensureCapacity(int)">ensureCapacity</A>, <A HREF="../../java/util/Vector.html#equals(java.lang.Object)">equals</A>, <A HREF="../../java/util/Vector.html#indexOf(java.lang.Object)">indexOf</A>, <A HREF="../../java/util/Vector.html#indexOf(java.lang.Object, int)">indexOf</A>, <A HREF="../../java/util/Vector.html#insertElementAt(java.lang.Object, int)">insertElementAt</A>, <A HREF="../../java/util/Vector.html#isEmpty()">isEmpty</A>, <A HREF="../../java/util/Vector.html#lastIndexOf(java.lang.Object)">lastIndexOf</A>, <A HREF="../../java/util/Vector.html#lastIndexOf(java.lang.Object, int)">lastIndexOf</A>, <A HREF="../../java/util/Vector.html#removeAllElements()">removeAllElements</A>, <A HREF="../../java/util/Vector.html#removeElement(java.lang.Object)">removeElement</A>, <A HREF="../../java/util/Vector.html#removeElementAt(int)">removeElementAt</A>, <A HREF="../../java/util/Vector.html#setElementAt(java.lang.Object, int)">setElementAt</A>, <A HREF="../../java/util/Vector.html#setSize(int)">setSize</A>, <A HREF="../../java/util/Vector.html#size()">size</A>, <A HREF="../../java/util/Vector.html#toArray()">toArray</A>, <A HREF="../../java/util/Vector.html#trimToSize()">trimToSize</A></CODE></TD>
194 </TR>
195 </TABLE>
196 &nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
197 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
198 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
199 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></B></TH>
200 </TR>
201 <TR BGCOLOR="white" CLASS="TableRowColor">
202 <TD><CODE><A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A></CODE></TD>
203 </TR>
204 </TABLE>
205 &nbsp;
206 <P>
207
208 <!-- ========= CONSTRUCTOR DETAIL ======== -->
209
210 <A NAME="constructor_detail"><!-- --></A>
211 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
212 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
213 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
214 <B>Constructor Detail</B></FONT></TH>
215 </TR>
216 </TABLE>
217
218 <A NAME="Stack()"><!-- --></A><H3>
219 Stack</H3>
220 <PRE>
221 public <B>Stack</B>()</PRE>
222 <DL>
223 <DD>creates a new Stack instance
224 <P>
225 </DL>
226
227 <!-- ============ METHOD DETAIL ========== -->
228
229 <A NAME="method_detail"><!-- --></A>
230 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
231 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
232 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
233 <B>Method Detail</B></FONT></TH>
234 </TR>
235 </TABLE>
236
237 <A NAME="push(java.lang.Object)"><!-- --></A><H3>
238 push</H3>
239 <PRE>
240 public <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> <B>push</B>(<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A>&nbsp;anObject)</PRE>
241 <DL>
242 <DD>pushes an object onto the stack
243 <P>
244 <DD><DL>
245 <DT><B>Parameters:</B><DD><CODE>anObject</CODE> - the object
246 <DT><B>Returns:</B><DD>Object the object pushed onto the stack</DL>
247 </DD>
248 </DL>
249 <HR>
250
251 <A NAME="pop()"><!-- --></A><H3>
252 pop</H3>
253 <PRE>
254 public <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> <B>pop</B>()
255            throws <A HREF="../../java/util/EmptyStackException.html" title="class in java.util">EmptyStackException</A></PRE>
256 <DL>
257 <DD>fetches an object from the top of the stack
258  and removes it
259 <P>
260 <DD><DL>
261
262 <DT><B>Returns:</B><DD>Object the object removed from the top of the stock
263 <DT><B>Throws:</B>
264 <DD><CODE><A HREF="../../java/util/EmptyStackException.html" title="class in java.util">EmptyStackException</A></CODE></DL>
265 </DD>
266 </DL>
267 <HR>
268
269 <A NAME="peek()"><!-- --></A><H3>
270 peek</H3>
271 <PRE>
272 public <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A> <B>peek</B>()
273             throws <A HREF="../../java/util/EmptyStackException.html" title="class in java.util">EmptyStackException</A></PRE>
274 <DL>
275 <DD>fetches an object from the stack
276  <br>does not remove it!
277 <P>
278 <DD><DL>
279
280 <DT><B>Returns:</B><DD>Object the object at the top of the stack
281 <DT><B>Throws:</B>
282 <DD><CODE><A HREF="../../java/util/EmptyStackException.html" title="class in java.util">EmptyStackException</A></CODE></DL>
283 </DD>
284 </DL>
285 <HR>
286
287 <A NAME="empty()"><!-- --></A><H3>
288 empty</H3>
289 <PRE>
290 public boolean <B>empty</B>()</PRE>
291 <DL>
292 <DD>is this stack empty?
293 <P>
294 <DD><DL>
295
296 <DT><B>Returns:</B><DD>boolean true, if the stack is empty</DL>
297 </DD>
298 </DL>
299 <!-- ========= END OF CLASS DATA ========= -->
300 <HR>
301
302
303 <!-- ======= START OF BOTTOM NAVBAR ====== -->
304 <A NAME="navbar_bottom"><!-- --></A>
305 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
306 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
307 <TR>
308 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
309 <A NAME="navbar_bottom_firstrow"><!-- --></A>
310 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
311   <TR ALIGN="center" VALIGN="top">
312   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
313   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
314   <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
315   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
316   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
317   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
318   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
319   </TR>
320 </TABLE>
321 </TD>
322 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
323 </EM>
324 </TD>
325 </TR>
326
327 <TR>
328 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
329 &nbsp;<A HREF="../../java/util/Random.html" title="class in java.util"><B>PREV CLASS</B></A>&nbsp;
330 &nbsp;<A HREF="../../java/util/Vector.html" title="class in java.util"><B>NEXT CLASS</B></A></FONT></TD>
331 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
332   <A HREF="../../index.html?java/util/Stack.html" target="_top"><B>FRAMES</B></A>  &nbsp;
333 &nbsp;<A HREF="Stack.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
334 &nbsp;<SCRIPT type="text/javascript">
335   <!--
336   if(window==top) {
337     document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
338   }
339   //-->
340 </SCRIPT>
341 <NOSCRIPT>
342   <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
343 </NOSCRIPT>
344
345
346 </FONT></TD>
347 </TR>
348 <TR>
349 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
350   SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#fields_inherited_from_class_java.util.Vector">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
351 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
352 DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
353 </TR>
354 </TABLE>
355 <A NAME="skip-navbar_bottom"></A>
356 <!-- ======== END OF BOTTOM NAVBAR ======= -->
357
358 <HR>
359
360 </BODY>
361 </HTML>