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

Remove Function
Symbol Table Class

Public Function Remove( _
      ByVal vName As Variant _
    , Optional ByVal vCompare As Variant _
    ) As Boolean

Remove a defintion (Name and Value pair) from the Symbol Table.
Function returns True if the Name was found and its Value was removed.
Function returns False otherwise.

       Dim stTemp As New SymbolTable
       stTemp.Add "FunctionName", 23
       stTemp.Add "FunctionName", 24
    for example
       stTemp.Remove("FunctionName") = True
       stTemp.Count = 1
See also:
    RemoveAll Subroutine
    Lookup Function
    Add Subroutine
vName: The string or numeric identifier of the Symbol Table entry that is to be removed.
vCompare: Specifies the type of string comparison used to determine if Names match. vCompare defaults to the value of the Compare Property if it is missing.
v2.0 Change: Changed the vCompare argument so that it can no longer be Null or non-numeric. It is still Optional though, so it can be missing.
Note: If there are multiple Symbol Table definitions with the same Name, this function will remove the one that was mostly-recently-added.
Performance: This function can be inefficient because it scans the Symbol Table from end to beginning looking for the spefied Name.

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