[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
CTOBIT()
Converts a character string into a bit pattern
------------------------------------------------------------------------------
Syntax
CTOBIT(<cCharacterstring>,<cBitpattern>) --> nWORD
Arguments
<cCharacterstring> Designates a character sequence. When this
sequence occurs in the second character string, each corresponding bit
is set to 1.
<cBitpattern> Designates a sequence, with a maximum of 16
characters, from which the bit position is assigned.
Returns
CTOBIT() returns a number in the range of 0 to 65535 that corresponds to
the created bit pattern.
Description
The CTOBIT() function delivers a bit pattern that corresponds to a
string of individual characters. When used in conjunction with its
sister function BITTOC(), it facilitates work with such bit-coded
information as file attributes.
Note
. Characters in <cCharacterstring> that are not found in
<cBitpattern> are ignored.
Examples
. The second bit in the resulting value is set, since the letter
"H" appears in the next-to-last position in "ADVSHR":
? CTOBIT("H", "ADVSHR") // Result: 00000010
. Two characters also in ADVSHR, appear at the first and final
positions in this 6-character string:
? CTOBIT("RA", "ADVSHR") // Result: 00100001
. <cBitpattern> ignores previously unavailable characters:
? CTOBIT("XRYA", "ADVSHR") // Result: 00100001
See Also:
BITTOC()
NTOC()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson