Function Stack Class

PopMulti

Pop one or more values off the top of the stack. Values are popped off the stack are assigned to the arguments from left-to-right. The top of the stack is assigned to the leftmost argument.

Signature (Visual Basic / VBA)

Public Function PopMulti( _
    ParamArray rValues() As Variant _
    ) As Integer

Code Example

    Assuming
       Dim intCount As Integer
       Dim varOne As Variant
       Dim varTwo As Variant
       stkTemp.StringView() = "(Top) 4444, 333, 22, 1 (Bottom)"
    for example
       intCount = stkTemp.PopMulti(varOne, varTwo)
    leaves
       intCount = 2
       varOne = 4444
       varTwo = 333
       stkTemp.StringView() = "(Top) 22, 1 (Bottom)"

Parameters

Parameter Description
rValues One or more arguments that will receive the values popped off the stack. The arguments can be any type of Variant value (vbString, numeric, vbDate, vbObject, vbArray, etc.) as long as they are compatible with the type of value being assigned into them.

Return Value

Function returns the number of values that were popped off the stack.

Notes & Version History

Note If you use the PushMulti subroutine to push multiple values onto the stack, then the arguments must be reversed if you use the PopMulti function to retrieve those values.
Note Use the Pop function instead of this function when you only need to pop one value off the stack.
v1.3 BugFix This Function has been fixed to support the retrieval of Object and DataObject type Values.