bitclear()

Function group Execute on client Platform(s)
Binary Field NO All

Syntax

bitclear(binary1,firstbitnumber,lastbitnumber)

Description

Clears a range of bits (all bits with numbers >=firstBitNumber and <=lastBitNumber) operating directly on binary. Returns a Boolean (true for success).

The function operates directly on the binary1 argument, and returns 1 for success and 0 for failure. If the bit numbers identify some bits which are outside the current length of the binary field, Omnis extends the field by appending bytes with value zero, and clears the bits.

Example

Calculate lStatus as bitclear(lBinary1,lFirstBitNumber,lLastBitNumber)