BitToC()

Converts position-dependent bits into characters

Syntax

       BITTOC(<nInteger>,<cBitpattern>,[<lMode>])
               --> <cBitString>

Arguments

<nInteger> Designates a number in the range of 0 to 65535, which corresponds to a bit pattern.

<cBitpattern> Designates a character string with a maximum of 16 characters. Each character corresponds to a bit in <nInteger>, where the last character corresponds to the lowest-value bit.

<lMode> When this optional parameter is designated as .T., 0 bits change to blanks. The default is no change.

Returns

The returned string contains the corresponding characters passed by the bit pattern.

Description

The BITTOC() function changes the bits of a number into a sequence of corresponding characters. This facilitates work with such bit-coded information as file attributes. Depending on the <lMode> logical parameter (the l in lMode symbolizes logical), 0 bits either displays no character (.F.) or a blank (.T.).

Note

. If <lMode> is designated as .T., the string length that results always corresponds to <cBitpattern>.

Examples

       .  Change file attributes:
           .  The number 2 corresponds to a binary "00000010":
              ? BITTOC(2, "ADVSHR")            // "H" as the next to
                                               // last character
           .  The number 5 corresponds to a binary "00000101":
              ? BITTOC(5, "ADVSHR")            // "SR"
           .  The number 5, with the 0 bit displayed as a blank:
              ? BITTOC(5, "ADVSHR", .T.)       // "   S R"

Files

Source is numconv.prg, library is libct.

See also

CTOBIT() CTON()