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

Duplicate Function
Stack Class

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

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

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)"
See also: 
    Over Function
    Pick Function
    Push Subroutine
    PushMulti Subroutine
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.

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