Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

IBCLR

Elemental Intrinsic Function (Generic): Clears one bit to zero.

result = IBCLR (i, pos)

i

(Input) Must be of type integer or of type logical (which is treated as an integer).

pos

(Input) Must be of type integer. It must not be negative and it must be less than BIT_SIZE(i).

The rightmost (least significant) bit of i is in position 0.

Results

The result type and kind are the same as i. The result has the value of the sequence of bits of i, except that bit pos of i is set to zero.

For more information, see Bit Functions.

The model for the interpretation of an integer value as a sequence of bits is shown in Model for Bit Data.

Specific Name

Argument Type

Result Type

BBCLR

INTEGER(1)

INTEGER(1)

IIBCLR1

INTEGER(2)

INTEGER(2)

JIBCLR

INTEGER(4)

INTEGER(4)

KIBCLR

INTEGER(8)

INTEGER(8)

1 Or HBCLR.

Example

IBCLR (18, 1) has the value 16.

If V has the value (1, 2, 3, 4), the value of IBCLR (POS = V, I = 15) is (13, 11, 7, 15).

The following shows another example:

INTEGER J, K
J = IBCLR(7, 1) ! returns 5 = 0101
K = IBCLR(5, 1) ! returns 5 = 0101