Intel® Fortran Compiler Classic and Intel® Fortran Compiler Developer Guide and Reference

ID 767251
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

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)

1Or 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