Determine scan behaviour in some string functions
SetAtLike ([<nMode>] [, <[@]cWildcard>]) --> nOldMode
CT_SetAtLike_EXACT -> characters are compared exactly
CT_SetAtLike_WILDCARD -> characters are compared using a wildcard character
The default value is CT_SetAtLike_EXACT.
[<[@]cWildcard>] determines the character that is subsequently used as a wildcard character for substring scanning. The default value is “?”.
NEW: If this parameter is passed by reference [@], the current wildcard character is stored in <cWildcard>.
nOldMode old (if nMode is a numeric value) or current state of the switch
In the following CT3 functions, strings are compared on a character base:
ATADJUST(), ATNUM(), AFTERATNUM(), BEFOREATNUM(), ATREPL(), NUMAT(), STRDIFF()
With the SetAtLike function, one can determine when characters are considered to match within these functions. If CT_SetAtLike_WILDCARD is set (e.g. “?”), then “?” matches every other character.
<nMode> can be one of the following values that are defined in ct.ch
Definition | Value ----------------------|------ CT_SetAtLike_EXACT | 0 CT_SetAtLike_WILDCARD | 1
This function is fully CT3 compatible, but allows to pass the second parameter by reference so that the current wildcard character can be determined.
Source is ctstr.c, header is ct.ch, library is ct3.