ishftc(3I)

NAME
     ISHFTC, IISHFTC, JISHFTC, KISHFTC - Performs a circular shift of the
     rightmost bits

SYNOPSIS
     ISHFTC ([I=]i, [SHIFT=]shift [,[SIZE=]size])
     IISHFTC ([I=]i, [SHIFT=]shift [,[SIZE=]size])
     JISHFTC ([I=]i, [SHIFT=]shift [,[SIZE=]size])
     KISHFTC ([I=]i, [SHIFT=]shift [,[SIZE=]size])

STANDARDS
     Fortran

     Fortran extensions:  IISHFTC, JISHFTC, KISHFTC

DESCRIPTION
     The ISHFTC, IISHFTC, JISHFTC, and KISHFTC intrinsic functions perform
     a circular shift of the rightmost bits.  They accept the following
     arguments:

     i         Must be of type integer.  For IISHFTC, must be of type
               integer (KIND=2).  For JISHFTC, must be of type integer
               (KIND=4).  For KISHFTC, must be of type integer (KIND=8).

     shift     Must be of type integer.  The absolute value of shift must
               be less than or equal to size.

     size      Must be of type integer.  The value of size must be positive
               and must not exceed BIT_SIZE(i).  If size is absent, it is
               as if it were present with the value of BIT_SIZE(i).

     These are elemental intrinsic functions.  The names of these
     intrinsics cannot be passed as arguments.

RETURN VALUES
     The result type and type parameter are the same as i.  The result has
     the value obtained by shifting the size rightmost bits of i circularly
     by shift positions.  If shift is positive, the shift is to the left;
     if shift is negative, the shift is to the right; and if shift is zero,
     no shift is performed.  No bits are lost.  The unshifted bits are
     unaltered.

     The bit model defines the interpretation of an integer value as a
     sequence of bits.  For more information on the model, see the
     MODELS(3I) man page.

EXAMPLES
     ISHFTC(3,2,3) yields 5.

SEE ALSO
     MODELS(3I)