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

Drop Function
Stack Class

Public Function Drop( _
    ByVal vNTimes As Long _
    ) As Boolean

Drop N items from the top of the stack.
Function returns True upon success and False upon failure.

Example:
    Assuming
       stkTemp.StringView() = "(Top) 4, 3, 2, 1 (Bottom)"
    for example
       stkTemp.Drop(2) = True
    leaves
       stkTemp.StringView() = "(Top) 2, 1 (Bottom)"
See also:
    Pop Function
    Remove Function
    RemoveAll Subroutine
vNTimes: The number of items to be removed from the top of the stack. The function does nothing and returns False if there are fewer than vNTimes items on the stack. This function also does nothing and returns False if vNTimes is less than or equal to zero (<=0).
v1.3 BugFix: This Function has been fixed to support the Drop of Object and DataObject type Values.

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