<-- Previous || Up || Next -->

Pop Function
Stack Class

Public Function Pop( _
    Optional ByRef rValue As Variant _
    ) As Boolean

Pop the value off the top of the stack and copy the value into rValue.
Function returns True upon success and False upon failure.

Example: 
    Assuming
       stkTemp.StringView() = "(Top) 4444, 333, 22, 1 (Bottom)"
       Dim varTemp As Variant
    for example
       stkTemp.Pop(varTemp) = True
    leaves
       varTemp = 4444
       stkTemp.StringView() = "(Top) 333, 22, 1 (Bottom)"
See also: 
    PopMulti Function
    Push Subroutine
    Item Property
    NthFromTop Property
    Deque Class
       StackPop Function
rValue: Value at the top of the Stack is moved into variable rValue. rValue must be compatible with the value that is being retrieved from the Stack. rValue is optional and can be omitted in order to remove the value from the Stack without returning the value.
Return Value: Function returns True upon success and False upon failure (when the Stack is empty).
v1.3 BugFix: This Function has been changed to return the retrieved value via an argument instead of via its return value. This is so that you do not have to know in advance whether the function will return an object reference or an ordinary value. Also, this Function has been fixed to support the retrieval of Object and DataObject type Values.

Copyright 1996-1999 Entisoft
Entisoft Tools is a trademark of Entisoft.