Function String Searches Class

GetTokenBufferedFast

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.

Signature (Visual Basic / VBA)

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

Code 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"

Parameters

Parameter Description
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.

Notes & Version History

Note Each Token must be within 4,096 characters of the current beginning of the line in order for this function to work correctly.