Pop (Arraylist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (1 revision)
Line 1: Line 1:
{{Template:Arraylist:Pop subtitle}}
{{Template:Arraylist:Pop subtitle}}
[[Category:Arraylist methods|Pop function]]
[[Category:Arraylist methods|Pop function]]
<!--DPL?? Category:Arraylist methods|Pop function: Retrieve last Arraylist item, then remove item-->
<!--DPL?? Category:Arraylist methods|<var>Pop</var> function: Retrieve last Arraylist item, then remove item-->
<p>
<p>
Pop is a member of the [[Arraylist class]].
<var>Pop</var> is a member of the [[Arraylist class]].
</p>
</p>


Line 9: Line 9:
in the method object Arraylist; then it removes that item.
in the method object Arraylist; then it removes that item.


Pop is available in ''Sirius Mods'' version 7.0 and later.
<var>Pop</var> is available in ''Sirius Mods'' version 7.0 and later.
==Syntax==
==Syntax==
{{Template:Arraylist:Pop syntax}}
{{Template:Arraylist:Pop syntax}}
Line 21: Line 21:
==Usage notes==
==Usage notes==
<ul>
<ul>
<li>The Pop method for object %arrayl is equivalent to
<li>The <var>Pop</var> method for object %arrayl is equivalent to
specifying <tt>%arrayl:[[Item (Arraylist property)|Item]](%arrayl:Count)</tt>
specifying <tt>%arrayl:[[Item (Arraylist property)|Item]](%arrayl:Count)</tt>
followed by <tt>%arrayl:[[RemoveItem (Arraylist function)|RemoveItem]](%arrayl:Count)</tt>.
followed by <tt>%arrayl:[[RemoveItem (Arraylist function)|RemoveItem]](%arrayl:Count)</tt>.

Revision as of 23:58, 19 January 2011

Retrieve last Arraylist item, then remove item (Arraylist class)

Pop is a member of the Arraylist class.

This callable function returns the current contents of the last item in the method object Arraylist; then it removes that item.

Pop is available in Sirius Mods version 7.0 and later.

Syntax

[%item =] al:Pop

Syntax terms

%item A variable of the same type as specified on the %arrayl declaration to contain the contents of the last %arrayl item.
%arrayl An Arraylist object.

Usage notes

  • The Pop method for object %arrayl is equivalent to specifying %arrayl:Item(%arrayl:Count) followed by %arrayl:RemoveItem(%arrayl:Count).
  • LastItem returns the last item of an Arraylist without removing it. Dequeue returns the first item of an Arraylist, then removes it.
  • The Push function, a synonym for Add, appends an item to an Arraylist.