mvbits(3I)

NAME
     MVBITS - Copies a sequence of bits from one integer data object to
     another

SYNOPSIS
     CALL MVBITS ([FROM=]from, [FROMPOS=]frompos, [LEN=]len, [TO=]to,
     [TOPOS=]topos)

IMPLEMENTATION
     UNICOS, UNICOS/mk, IRIX systems

     CF90, MIPSpro 7 Fortran 90

STANDARDS
     Fortran

DESCRIPTION
     The MVBITS intrinsic subroutine copies a sequence of bits from one
     integer data object to another.  It accepts the following arguments:

     from      Must be of type integer.  It is an INTENT (IN) argument.

     frompos   Must be of type integer and nonnegative.  It is an INTENT
               (IN) argument.  frompos + len must be less than or equal to
               BIT_SIZE (from).  The bit model defines the interpretation
               of an integer value as a sequence of bits.  For more
               information on the bit model see the MODELS(3I) man page.

     len       Must be of type integer and nonnegative.  It is an INTENT
               (IN) argument.

     to        Must be a variable of type integer with the same kind type
               parameter value as from and may be the same variable as
               from.  It is an INTENT (INOUT) argument.  to is set by
               copying the sequence of bits of length len, starting at
               position frompos of from to position topos of to.  No other
               bits of to are altered.  On return, the len bits of to
               starting at topos are equal to the value that the len bits
               of from starting at frompos had on entry.

     topos     Must be of type integer and nonnegative.  It is an INTENT
               (IN) argument.  topos + len must be less than or equal to
               BIT_SIZE (to).

     MVBITS is an elemental subroutine.  The name of this intrinsic cannot
     be passed as an argument.

EXAMPLES
     If TO has the initial value 6, the value of TO after the statement
     CALL MVBITS(7, 2, 2, TO, 0) is 5.

SEE ALSO
     MODELS(3I)

     Intrinsic Procedures Reference Manual for the printed version of this
     man page.