[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 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 CA-Clipper Tools, that affects
     the operation of several other CA-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()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson