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

Remove Tail Function
Deque Class

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

Deletes the value at the tail of a deque and returns that value.

Example:
    Assuming
       Dim dqTemp As New Deque
       dqTemp.AddTail 12
       dqTemp.AddTail "Sam"
       Dim varTemp As Variant
       Dim bResult As Boolean
    for example
       bResult = dqTemp.RemoveTail(varTemp)
    leaves
       bResult = True
       varTemp = "Sam"
    also
       bResult = dqTemp.RemoveTail(varTemp)
    leaves
       bResult = True
       varTemp = 12
See also:
    RemoveHead Function
    RemoveAll Subroutine
    Tail Property
    AddTail Subroutine
rValue: Value at the tail of the Deque is assigned into variable rValue. rValue must be compatible with the value that is being retrieved from the Deque. rValue is optional and can be omitted in order to remove the value from the Deque without returning the value.
Return Value: Function returns True upon success and False upon failure (when the Deque 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.