Click above to get retro games delivered to your door ever month!

CSETALL()

Syntax:     CSETALL([<expC>])

Arguments:  <expC> specifies a string that must be in a specific format,
            defining which switches are to be set ON and which are to
            to be OFF.

Returns:    A character string.
            The function will return the current setting of all ON/OFF
            switches.

Usage:      This function can be used to determine the current setting of
            all ON/OFF switches in Clipper and optionally change them
            at the same time.  The function will return 21 switch settings
            in one string.  The string will be 21 bytes long, where each
            byte will be a 0 or a 1.  This function can be effectively
            used to save all ON/OFF switches in Clipper's error handling
            functions and to reset them again when exiting.

Notes:      The switches shown below are contained in the string
            (in order of appearance in the string).

            Code              Definition
            ----              ----------
            CSETALTE()        setting of SET ALTERNATE
            CSETBELL()        setting of SET BELL
            CSETCARR()        setting of SET CARRY
            CSETCENT()        setting of SET CENTURY
            CSETCONF()        setting of SET CONFIRM
            CSETCONS()        setting of SET CONSOLE
            CSETCURS()        setting of SET CURSOR
            CSETDELE()        setting of SET DELETED
            CSETDELI()        setting of SET DELIMITERS
            CSETDEVI()        setting of SET DEVICE
            CSETESCA()        setting of SET ESCAPE
            CSETEXAC()        setting of SET EXACT
            CSETEXCL()        setting of SET EXCLUSIVE
            CSETFIXE()        setting of SET FIXED
            READINSERT()      setting of INSERT mode
            CSETINTE()        setting of SET INTENSITY
            CSETPRIN()        setting of SET PRINT
            CSETSCOR()        setting of SET SCOREBOARD
            CSETSOFT()        setting of SET SOFTSEEK
            CSETUNIQ()        setting of SET UNIQUE
            CSETWRAP()        setting of SET WRAP

            If an invalid argument is specified, the function will return a
            null string and will not change any of the switches.

            You may have realized that SET CARRY is a non-functional
            command in Clipper, supported purely for compatibility
            reasons.  You can therefore ignore this function.  It is still a
            mandatory argument in CSETALL() even though it has no effect.

Warning:    CSETSNOW() is not  one of Clipper's internal switches.  It
            has therefore not been implemented into CSETALL().

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   switches = CSETALL()

            * Return: 010000000000000000000

            IF SUBSTR(switches,2,1) = "1"
               ? "Bell is switched on."
            ENDIF