MVBITS(3I) Last changed: 1-6-98
NAMEMVBITS - 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, and IRIX systems
STANDARDS
Fortran 90
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 ALSOMODELS(3I)
Intrinsic Procedures Reference Manual, publication SR-2138, for the
printed version of this man page.