ishftc(3I)

NAME
     ISHFTC - Performs a circular shift of the rightmost bits

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

IMPLEMENTATION
     UNICOS, UNICOS/mk, and IRIX systems

STANDARDS
     Fortran 90

DESCRIPTION
     The ISHFTC intrinsic function performs a circular shift of the
     rightmost bits.  It accepts the following arguments:

     i         Must be of type integer.

     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).

     ISHFTC is an elemental function.  The name of this intrinsic cannot be
     passed as an argument.

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) has the value 5.

SEE ALSO
     MODELS(3I)

     Intrinsic Procedures Reference Manual, publication SR-2138, for the
     printed version of this man page.