1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<TITLE>deleteFromStack and deleteAllFromStack</TITLE>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<BODY>
<HR>
<div align="center"><img id="headerGraphic" src="images/sludge300.png" alt="SLUDGE"/></div>
<h2>deleteFromStack and deleteAllFromStack</h2>
<HR>
<H3>Syntax:</H3>
<P>
<pre class="syntax">deleteFromStack (<i>thisStack, thisElement</i>);</pre>
</P>
<P>
<pre class="syntax">deleteAllFromStack (<i>thisStack, thisElement</i>);</pre>
</P>
<H3>Purpose:</H3>
<P>
These functions remove instances of <i>thisElement</i> from <i>thisStack</i>. The standard SLUDGE equality test is performed on each element of the stack and the value of <i>thisElement</i> - if they are the same, the element is removed from the stack. The deleteFromStack function will stop after finding and removing one match; deleteAllFromStack will remove all instances of <i>thisElement</i> which are found.
</P>
<H3>Return value:</H3>
<P>
The command returns the number of elements removed from the stack.
</P>
<H3>See also: </H3>
<P>
<a href="The_Multi-Purpose_Stack___Array___Queue_Type.html">The Multi-Purpose Stack / Array / Queue Type</a>
</P>
<P>
<a href="copyStack.html">copyStack</a>
</P>
<P>
<a href="enqueue.html">enqueue</a>
</P>
<P>
<a href="dequeue.html">dequeue</a>
</P>
<P>
<a href="newStack.html">newStack</a>
</P>
<P>
<a href="popFromStack.html">popFromStack</a>
</P>
<P>
<a href="pushToStack.html">pushToStack</a>
</P>
<P class="copyright-notice">SLUDGE and this SLUDGE documentation are <A HREF="Copyright.html">copyright</A> Hungry Software and contributors 2000-2012
</P>
<HR>
</BODY>
</html>
|
