[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
BITTOC()
Converts position-dependent bits into characters
------------------------------------------------------------------------------
Syntax
BITTOC(<nInteger>,<cBitpattern>,[<lMode>])
--> cCharacterstring
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"
See Also:
CTOBIT()
CTON()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson