---

Manual Reference Pages  - dshiftr (3fortran)

---

NAME

DSHIFTR(3) - [BIT:COPY] Combined right shift of the bits of two integers

SYNOPSIS

result = dshiftr(i, j, shift)

         elemental integer(kind=KIND) function dshiftr(i, j, shift)

          integer(kind=KIND),intent(in) :: i
          integer(kind=KIND),intent(in) :: j
          integer(kind=**),intent(in) :: shift

CHARACTERISTICS

o	a kind designated as ** may be any kind value for the integer type
o	the kind of I, J, and the return value are the same. An exception is that one of I and J may be a BOZ literal constant (A BOZ literal constant is a binary, octal or hex constant).
o	If either I or J is a BOZ-literal-constant, it is first converted as if by the intrinsic function INT(3) to type integer with the kind type parameter of the other.

DESCRIPTION

DSHIFTR(3) combines bits of I and J. The leftmost SHIFT bits of the result are the rightmost SHIFT bits of I, and the remaining bits are the leftmost bits of J.

It may be thought of as appending the bits of I and J, dropping off the SHIFT rightmost bits, and then retaining the same number of rightmost bits as an input value, hence the name "combined right shift"...

Given two 16-bit values labeled alphabetically ...

       i=ABCDEFGHIJKLMNOP
       j=abcdefghijklmnop

Append them together

       ABCDEFGHIJKLMNOPabcdefghijklmnop

Shift them N=6 bits to the right dropping off bits

             ABCDEFGHIJKLMNOPabcdefghij

Keep the 16 right-most bits

                       KLMNOPabcdefghij

NOTE

DSHIFR(I,J,SHIFT) is equivalent to

         ior(shiftl (i, bit_size(i) - shift), shiftr(j, shift) )

it can also be seen that if I and J have the same value

         dshiftr( i, i, shift )

this has the same result as a negative circular shift

         ishftc( i,   -shift ).

OPTIONS

o	I : left value of the pair of values to be combine-shifted right
o	J : right value of the pair of values to be combine-shifted right
o	SHIFT : the shift value is non-negative and less than or equal to the number of bits in an input value as can be computed by BIT_SIZE(3).

RESULT

The result is a combined right shift of I and J that is the same as the bit patterns of the inputs being combined left to right, dropping off SHIFT bits on the right and then retaining the same number of bits as an input value from the rightmost bits.

EXAMPLES

Sample program:

    program demo_dshiftr
    use,intrinsic :: iso_fortran_env, only : int8, int16, int32, int64
    implicit none
    integer(kind=int32) :: i, j
    integer             :: shift

      ! basic usage
       write(*,*) dshiftr (1, 2**30, 2)

      ! print some calls as binary to better visualize the results
       i=-1
       j=0
       shift=5

       ! print values
        write(*,’(*(g0))’)’I=’,i,’ J=’,j,’ SHIFT=’,shift
        write(*,’(b32.32)’) i,j, dshiftr (i, j, shift)

      ! visualizing a "combined right shift" ...
       i=int(b"00000000000000000000000000011111")
       j=int(b"11111111111111111111111111100000")
       ! appended together ( i//j )
       ! 0000000000000000000000000001111111111111111111111111111111100000
       ! shifted right SHIFT values dropping off shifted values
       !      00000000000000000000000000011111111111111111111111111111111
       ! keep enough rightmost bits to fill the kind
       !                                 11111111111111111111111111111111
       ! so the result should be all 1s bits ...

        write(*,’(*(g0))’)’I=’,i,’ J=’,j,’ SHIFT=’,shift
        write(*,’(b32.32)’) i,j, dshiftr (i, j, shift)

    end program demo_dshiftr

Results:

     >    1342177280
     >  I=-1 J=0 SHIFT=5
     >  11111111111111111111111111111111
     >  00000000000000000000000000000000
     >  11111000000000000000000000000000
     >  I=31 J=-32 SHIFT=5
     >  00000000000000000000000000011111
     >  11111111111111111111111111100000
     >  11111111111111111111111111111111

STANDARD

Fortran 2008

SEE ALSO

DSHIFTL(3)

fortran-lang intrinsic descriptions (license: MIT) @urbanjost

---

Nemo Release 3.1

dshiftr (3fortran)

April 28, 2024

Generated by manServer 1.08 from 741e956a-38b5-465d-adc2-64bb63f76b1c using man macros.