Pop (Arraylist function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (match syntax diagram to template and fix tags) |
||
| Line 1: | Line 1: | ||
{{Template:Arraylist:Pop subtitle}} | {{Template:Arraylist:Pop subtitle}} | ||
This callable function returns the current contents of the last item | This callable function returns the current contents of the last item in the method object <var>Arraylist</var>; then it removes that item. | ||
in the method object <var>Arraylist</var>; then it removes that item. | |||
==Syntax== | ==Syntax== | ||
{{Template:Arraylist:Pop syntax}} | {{Template:Arraylist:Pop syntax}} | ||
| Line 10: | Line 8: | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th><i>%item</i></th> | <tr><th><i>%item</i></th> | ||
<td> | <td>An, optional, variable of the same type as specified on the <var class="term">al</var> declaration to contain the contents of the last <var class="term">al</var> item. </td></tr> | ||
<tr><th><i><var class="term">al</var></i></th> | <tr><th><i><var class="term">al</var></i></th> | ||
<td>An <var>Arraylist</var> object.</td></tr> | <td>An <var>Arraylist</var> object.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<ul> | <ul> | ||
<li>The <var>Pop</var> method for object <var class="term">al</var> is equivalent to | <li>The <var>Pop</var> method for object <var class="term">al</var> is equivalent to specifying <code><var class="term">al</var>:<var>[[Item (Arraylist property)|Item]]</var>(<var class="term">al</var>:<var>[[Count (Arraylist property)|Count]]</var>)</code> followed by <code><var class="term">al</var>:<var>[[RemoveItem (Arraylist function)|RemoveItem]]</var>(<var class="term">al</var>:<var>[[Count (Arraylist property)|Count]]</var>)</code>. | ||
specifying < | |||
followed by < | <li><var>Pop</var> is available in <var class="product">Sirius Mods</var> version 7.0 and later. | ||
</ul> | </ul> | ||
==See also== | ==See also== | ||
<ul> | |||
<li><var>[[LastItem (Arraylist property)|LastItem]]</var> returns the last item of an <var>Arraylist</var> without removing it. | |||
<li><var>[[Dequeue (Arraylist function)|Dequeue]]</var> returns the first item of an <var>Arraylist</var>, then removes it. | |||
<li><var>[[Push (Arraylist function)|Push]]</var>, a synonym for Add, appends an item to an <var>Arraylist</var>. | |||
</ul> | |||
{{Template:Arraylist:Pop footer}} | {{Template:Arraylist:Pop footer}} | ||
Revision as of 05:56, 30 January 2011
Retrieve last Arraylist item, then remove item (Arraylist class)
This callable function returns the current contents of the last item in the method object Arraylist; then it removes that item.
Syntax
[%item =] al:Pop
Syntax terms
| %item | An, optional, variable of the same type as specified on the al declaration to contain the contents of the last al item. |
|---|---|
| al | An Arraylist object. |
Usage notes
- The Pop method for object al is equivalent to specifying
al:Item(al:Count)followed byal:RemoveItem(al:Count). - Pop is available in Sirius Mods version 7.0 and later.
See also
- LastItem returns the last item of an Arraylist without removing it.
- Dequeue returns the first item of an Arraylist, then removes it.
- Push, a synonym for Add, appends an item to an Arraylist.