CSETATMUPA() Determines the setting of the multi-pass mode for ATXXX() functions ------------------------------------------------------------------------------ Syntax CSETATMUPA(<lNewMode>) --> lOldMode Argument <lNewMode> Designates the setting for the multi-pass switch for all AT functions. The default value (.F.) sets the multi-pass switch to off Returns If <lNewMode> is not specified, the current setting is returned. If <lNewMode> is specified, CSETATMUPA() returns the previous setting. Description CSETATMUPA() sets a switch, internal to Clipper Tools, that affects the operation of several other Clipper Tools functions. These functions permit targeted, extremely flexible substring manipulation. The affected functions are: ATNUM() AFTERATNUM() BEFORATNUM() ATREPL() NUMAT() ATADJUST() WORDTOCHAR() WORDREPL() The CSETATMUPA() function sets the multi-pass mode on or off for these functions. Note . The default setting for CSETATMUPA() is .F., indicating that the multi-pass mode is off. Example Switch the multi-pass mode on and save the previous setting: lOldMupa := CSETATMUPA(.T.)
See Also: ATNUM() AFTERATNUM() BEFORATNUM() ATREPL()