cStringCharacterRequired
Bit string.
FUNCTIONUnder review
BITON()
BitOn( <cString>, <nInitialBit>, <nCountBits>, <nStringSize> )Records the partial string-bit activation contract.
Overview
The BITON() page describes setting bits in a string through four arguments: string, initial bit, bit count and string size. This is not a numeric BitOn(nNumber,nBit) signature. The page does not clarify index base, return representation or invalid-bound behavior. This review therefore provides no expected binary result and does not recommend use for real permission fields or formats. The example isolates a diagnostic call on a fictional byte and records only the returned type, subject to testing. (TOTVS, n.d., ref. 1)
Syntax
BitOn( <cString>, <nInitialBit>, <nCountBits>, <nStringSize> )Parameters
nInitialBitNumericRequired
Initial bit; base unspecified.
nCountBitsNumericRequired
Bit count.
nStringSizeNumericRequired
String size.
Return value
Unspecified in the page; verify type and content in testing.
Commented example
#Include "Protheus.ch"
User Function EdBiton()
Local cTest := Chr(0)
Local xReturn
// Isolated diagnostic; not a production format.
xReturn := BitOn(cTest, 1, 1, Len(cTest))
ConOut(ValType(xReturn))
Return NilExpected result
Return type to be verified; no binary value is assumed. Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
- Record build, hexadecimal input and output in isolated tests before extending semantics. Do not substitute a similarly named numeric API.
- Under review: editorial example neither compiled nor run in Protheus. Check includes, release, RDD and context before testing.
Comments
There are no approved comments yet.
Sign in with Google or Microsoft to comment.