Function Stack Class

Duplicate

Duplicate the top N values on the stack. Function returns True upon success and False upon failure.

Signature (Visual Basic / VBA)

Public Function Duplicate( _
    ByVal vTopN As Long _
    ) As Boolean

Code Example

    Assuming
       stkTemp.StringView() = "(Top) 3, 2, 1 (Bottom)"
    for example
       stkTemp.Duplicate(2) = True
    leaves
       stkTemp.StringView() = "(Top) 3, 2, 3, 2, 1 (Bottom)"

Notes & Version History

vNTimes The number of items on the top of the stack that are to be duplicated. The function does nothing and returns False if there are fewer than vTopN items on the stack. This function also does nothing and returns False if vTopN is less than or equal to zero (<=0).
v1.3 BugFix This Function has been fixed to support the Duplication of Object and DataObject type Values.