String Searches Class

Entisoft Tools 2.0 Object Library
Version 2.1 Build 208
<-- Previous || Index || Main || Topics || Next -->

Declarations Section, AverageLengthAnyPart Function, CountCharacters Function, CountLeadingStrings Function, CountLines Function, CountOverlappingMatches Function, CountStrings Function, CountTrailingStrings Function, FirstLowerCaseForward Function, FirstMatchingCharacter Function, FirstMatchingPosition Function, FirstNonLowerCaseForward Function, FirstNonMatchingCharacter Function, FirstNonMatchingPosition Function, FirstNonUpperCaseForward Function, FirstUpperCaseForward Function, GetPossiblyQuotedField Function, GetToken Function, GetTokenSample Sub, GetTokenFast Function, GetTokenFastSample Sub, GetTokenBufferedFast Function, GetTokenCharSeps Function, GetTokenAlphanumeric Function, GetTokenNonSpace Function, IndicateMatches Function, InStrCharacters Function, InStrCharactersFast Function, InStrCharactersBinary Function, InStrCharactersReverse Function, InStrCharactersReverseFast Function, InStrNotCharacters Function, InStrNotCharactersReverse Function, InStrReverse Function, InStrReverseFast Function, InStrToVariantVector Function, LastMatchingCharacter Function, LastNonMatchingCharacter Function, LeftOfFirstMatch Function, LeftOfFirstMatchFast Function, LeftOfLastMatch Function, LeftOfLastMatchFast Function, LineBeginsWith Function, LineBeginsWithFast Function, LineEndsWith Function, LineEndsWithFast Function, MatchesInContext Function, MatchesInContextSample Sub, MaxCorrespondingCharacters Function, MaxLengthAnyPart Function, MinCorrespondingCharacters Function, MinLengthAnyPart Function, RightOfFirstMatch Function, RightOfFirstMatchFast Function, RightOfLastMatch Function, RightOfLastMatchFast Function, StringBetweenStrings Function, StringBetweenStringsFast Function, StringsBetweenStrings Function, StringsBetweenStringsFast Function

Declarations Section
 
Average Length Any Part Function
Return the average length of any part of a string. Does not include the length of the string which separates the parts in the average. The "parts" of the string are the sub-strings between occurrences of the string vPartSeparator.
Count Characters Function
Count the number of occurrences of the characters in vFindChars within string vLine.
Count Leading Strings Function
Count the number of occurrences of one string at the beginning of another.
Count Lines Function
Count the number of lines within a string. Works for Windows, DOS, and UNIX strings since it considers the line feed character to be the line terminator.
Count Overlapping Matches Function
Count the number of (possibly-overlapping) occurrences of the string vFind within vLine.
Count Strings Function
Count the number of (non-overlapping) occurrences of the string vFind within vLine.
Count Trailing Strings Function
Count the number of occurrences of one string (vFind) at the end of another (vLine).
First Lower Case Forward Function
Return the string vLine starting with the first lower-case character. Skips all of the characters in vLine up to the first lower-case character. Uses the Visual Basic UCase$() function and not the built-in character classification routines.
First Matching Character Function
Returns the first character within string vLine that matches any of the characters within string vFindChars.
First Matching Position Function
Returns the position of the first matching characters in corresponding positions of the two strings.
First Non Lower Case Forward Function
Return the string vLine starting with the first non-lower-case character. Skips all of the characters in vLine up to the first non-lower-case character. Uses the Visual Basic UCase$() function and not the built-in character classification routines.
First Non Matching Character Function
Returns the first character within string vLine that does not match any of the characters within string vFindChars.
First Non Matching Position Function
Returns the position of the first non-matching characters in corresponding positions of the two strings.
First Non Upper Case Forward Function
Return the string vLine starting with the first non-upper-case character. Skips all of the characters in vLine up to the first non-upper-case character. Uses the Visual Basic LCase$() function and not the built-in character classification routines.
First Upper Case Forward Function
Return the string vLine starting with the first upper-case character. Skips all of the characters in vLine up to the first upper-case character. Uses the Visual Basic LCase$() function and not the built-in character classification routines.
Get Possibly Quoted Field Function
Remove the first (possibly quoted) value from a string and return that value. Similar to the GetToken functions, except that token can appear within quotes.
Get Token Function
Remove the first token from the argument and return the token. The tokens are separated by the string vTokenSep.
Get Token Sample Sub
Print some samples of the GetToken function.
Get Token Fast Function
Remove the first token from the argument and return the token. The tokens are separated by the string vTokenSep. Faster version of the GetToken function which has restrictive argument types to avoid argument fix up overhead.
Get Token Fast Sample Sub
Print some samples of the GetTokenFast function.
Get Token Buffered Fast Function
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.
Get Token Char Seps Function
"Get Token With Character Separators" Remove the first token from the argument and return the token. The tokens are separated by any of the characters within string vCharSeps.
Get Token Alphanumeric Function
"Get Alphanumeric Token" Remove the first alphanumeric token from the argument and return the token. Function skips leading non-alphanumeric characters (spaces, tabs, symbols, punctuation, etc.) before returning the first alphanumeric token.
Get Token Non Space Function
"Get Non-space Token" Remove the first non-space token from the argument and return the token. Function skips leading space-type characters (spaces, tabs, line feeds, etc.) before returning the first token.
Indicate Matches Function
Indicate which non-overlapping portions of one string match a specific string. Function includes the original string followed carriage return and line feed and then the string which indicates the matching portion using up-caret characters."
In Str Characters Function
"In String Characters" Return the first position within string vLine of any of the characters within vFindChars.
In Str Characters Fast Function
"In String Characters (Fast)" Return the first position within string vLine of any of the characters within vFindChars. Faster version of the InStrCharacters function which uses restrictive argument types to avoid argument fix-up code.
In Str Characters Binary Function
"In String Chracters Binary" Return the first position within string vLine of any of the characters within vFindChars. Alternate algorithm which has different performance characteristics than the InStrCharacters function. This algorithm only works for Binary Comparison.
In Str Characters Reverse Function
"In String Characters Reverse" Return the last position within string vLine of any of the characters within vFindChars. Similar to the InStrCharacters function except that this one searches the string vLine from right-to-left.
In Str Characters Reverse Fast Function
"In String Characters Reverse (Fast)" Return the last position within string vLine of any of the characters within vFindChars. Faster version of the InStrCharacters function which uses restrictive argument types to avoid argument fix-up code.
In Str Not Characters Function
"In String Not Characters" Return the position of the first character in vLine that is NOT in vFindChars.
In Str Not Characters Reverse Function
"In String Not Characters Reverse" Return the position of the last character in vLine that is NOT in vFindChars.
In Str Reverse Function
"In String Reverse" Find the last occurrence of one string within another. Similar to the Visual Basic InStr function except that it searches backwards from the end of string vLine. Different from the InStr function in that it returns 0 if vFind is an empty string.
In Str Reverse Fast Function
"In String Reverse (Fast)" Find the last occurrence of one string within another. Faster version of the InStrReverse function which uses restrictive argument types to avoid argument fix-up code.
In Str To Variant Vector Function
"In String To Variant Vector" Creates a list of all of the non-overlapping positions of one string within another string.
Last Matching Character Function
Returns the last character within string vLine that matches any of the characters within string vFindChars.
Last Non Matching Character Function
Returns the first character within string vLine that does not match any of the characters within string vFindChars.
Left Of First Match Function
Return the portion of vLine before the first occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned.
Left Of First Match Fast Function
Return the portion of vLine before the first occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned. Faster version of the LeftOfFirstMatch function which uses restrictive argument types to avoid argument fix-up code.
Left Of Last Match Function
Return the portion of vLine before the last occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned.
Left Of Last Match Fast Function
Return the portion of vLine before the last occurrence of vFind, else return vIfNotFound. Faster version of the LeftOfLastMatch function which uses restrictive argument types to avoid argument fix-up code. If a match is found, it does not include the matching text in the string that is returned.
Line Begins With Function
Returns True if the string vLine begins with the string vFind.
Line Begins With Fast Function
Returns True if the string vLine begins with the string vFind. Faster version of the LineBeginsWith function which uses restrictive argument types to avoid argument fix-up code.
Line Ends With Function
Returns True if the string vLine ends with the string vFind.
Line Ends With Fast Function
Returns True if the string vLine ends with the string vFind. Faster version of the LineEndsWith function which uses restrictive argument types to avoid argument fix-up code.
Matches In Context Function
Return a string containing all of the occurrences of vFind within vSearch, and include up to vContextChars characters of the surrounding text on each side of the match.
Matches In Context Sample Sub
Sample of the MatchesInContext function.
Max Corresponding Characters Function
"Maximum Corresponding Characters" Return a string where each character represents the maximum ASCII value of the characters in the corresponding position within all of the string arguments. Will return the character from the first string with the maximum value if many characters tie for the maximum.
Max Length Any Part Function
"Maximum Length Any Part" Return the maximum length of any part of the input string, after the string has been separated at each occurrence of the vPartSep string.
Min Corresponding Characters Function
"Minimum Corresponding Characters" Return a string where each character represents the minimum ASCII value of the characters in the corresponding position within all of the string arguments. Will return the character from the first string with the minimum value if many characters tie for the minimum.
Min Length Any Part Function
"Minimum Length Any Part" Return the minimum length of any part of the input string, after the string has been separated at each occurrence of the vPartSep string.
Right Of First Match Function
Return the portion of vLine after the first occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned.
Right Of First Match Fast Function
Return the portion of vLine after the first occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned. Faster version of the RightOfFirstMatch function which uses restrictive argument types to avoid argument fix-up code.
Right Of Last Match Function
Return the portion of vLine after the last occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned.
Right Of Last Match Fast Function
Return the portion of vLine after the last occurrence of vFind, else return vIfNotFound. If a match is found, it does not include the matching text in the string that is returned. Faster version of the RightOfLastMatch function which uses restrictive argument types to avoid argument fix-up code.
String Between Strings Function
Return the string between the first occurrences of vRight and vLeft.
String Between Strings Fast Function
Return the string between the first occurrences of vRight and vLeft. Faster version of the StringBetweenStrings function which uses restrictive argument types to avoid argument fix-up code.
Strings Between Strings Function
Return the strings between all occurrences of vRight and vLeft. If more than one match is found, the matches are separated by vSeparator. Return a blank string if there is no match of vLeft followed by vRight.
Strings Between Strings Fast Function
Return the strings between the all occurrences of vRight and vLeft. If more than one match is found, the matches are separated by vSeparator. Return a blank string if there is no match of vLeft followed by vRight. Faster version of the StringaBetweenStrings function which uses restrictive argument types to avoid argument fix-up code.

This Windows-based ActiveX DLL provides many useful routines through its function-bearing and data structure classes. Consult the Help file for more information, or call us at 1-310-472-3736. For the latest news and files, visit our home page on the World Wide Web: http://www.entisoft.com

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