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

Get Token Buffered Fast Function
String Searches Class

Public Function GetTokenBufferedFast( _
      ByRef rValue As String _
    , ByRef rBuffer As String _
    , ByVal vTokenSep As String _
    , ByVal vCompare As VbCompareMethod _
    ) As String

Remove the first token from the argument and return the token.
The tokens are separated by the string vTokenSep.
Special version of the GetToken Function which has restrictive argument types to avoid argument fix up overhead AND also works very efficiently on large strings.

Example:
    Assuming
       Dim S As String
       S = "First,Second,Third"
       Dim B As String
    for example
       GetTokenFast(S, B, ",", vbBinaryCompare) = "First"
    leaves
       S = "Second,Third"
See also:
    GetToken Function
    GetTokenCharSeps Function
    GetTokenAlphanumeric Function
    GetTokenNonSpace Function
    GetVBToken Function
    GetOpt Function
    strtok Function
    GetTokenFastSample Subroutine
rValue: The string containing the tokens of which the first is to be removed and returned.
rBuffer: A string buffer which is used to speed the processing of very large strings.
vTokenSep: The string which separates the tokens within string rValue. If the token separator vTokenSep is an empty string, then the string rValue is considered to consist of a single token.
vCompare: Specifies the type of comparison used to determine if the token separator string vTokenSep appears within the string rValue.
Note: Each Token must be within 4,096 characters of the current beginning of the line in order for this function to work correctly.

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