*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> f90/shiftr (3)              
Title
Content
Arch
Section
 

Contents


SHIFTR(3I)					       Last changed: 1-6-98

NAME    [Toc]    [Back]

     SHIFTR - Performs a right shift with zero fill

SYNOPSIS    [Toc]    [Back]

     SHIFTR ([I=]i,[J=]j)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     CF90 and MIPSpro 7	Fortran	90 compiler extension to Fortran 90

DESCRIPTION    [Toc]    [Back]

     The SHIFTR	intrinsic function performs a right shift with zero fill of
     the i by j	bits.  It accepts the following	arguments:

     i	  The value to be shifted.  i can be of	type Boolean, integer,
	  real,	or Cray	pointer.

     j	  The number of	bits to	shift the value.  Must be of type integer
	  or Boolean.  j must be within	the range 0 <= j <=size, where size
	  is the size, in bits,	of i.  That is,	if i is	a 64-bit object, j
	  must be within the range 0 <=	j <= 64.

     On	UNICOS systems,	an object is 64	bits.  On UNICOS/mk systems, an
     object is 32 bits or 64 bits.  On IRIX systems, an	object is 8 bits,
     16	bits, 32 bits, or 64 bits.

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

NOTES    [Toc]    [Back]

     This is an	outmoded routine.  Refer to the	Fortran	Language Reference
     Manual, Volume 2, publication SR-3903, for	information about outmoded
     features and their	preferred standard alternatives.

     The bit representation of the logical data	type is	not consistent
     among Cray	Research systems.  For further details,	see your compiler's
     reference manuals.

RETURN VALUES    [Toc]    [Back]

     SHIFTR returns a value of type Boolean on UNICOS and UNICOS/mk
     systems.  It returns an integer result on IRIX systems.

EXAMPLES    [Toc]    [Back]

     The following section of Fortran code shows the SHIFTR function used
     in	the case where i is of type integer.  The bit pattern of i and the
     bit pattern of the	result are also	given.	For simplicity,	a 16-bit
     object is used.

	  INTEGER I1, I2, I3
	  ...
	  I2 = 5
	  I3 = SHIFTR(I1,I2)

	   ---------------------------------------------------------------
	  | 1 |	1 | 1 |	1 | 1 |	1 | 1 |	1 | 0 |	0 | 0 |	0 | 0 |	0 | 0 |	0 |
	   ---------------------------------------------------------------
				       I1 (i)

	   ---------------------------------------------------------------
	  | 0 |	0 | 0 |	0 | 0 |	1 | 1 |	1 | 1 |	1 | 1 |	1 | 1 |	0 | 0 |	0 |
	   ---------------------------------------------------------------
				       I3 (result)

SEE ALSO    [Toc]    [Back]

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

SHIFTR(3I)					       Last changed: 1-6-98

NAME    [Toc]    [Back]

     SHIFTR - Performs a right shift with zero fill

SYNOPSIS    [Toc]    [Back]

     SHIFTR ([I=]i,[J=]j)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     CF90 and MIPSpro 7	Fortran	90 compiler extension to Fortran 90

DESCRIPTION    [Toc]    [Back]

     The SHIFTR	intrinsic function performs a right shift with zero fill of
     the i by j	bits.  It accepts the following	arguments:

     i	  The value to be shifted.  i can be of	type Boolean, integer,
	  real,	or Cray	pointer.

     j	  The number of	bits to	shift the value.  Must be of type integer
	  or Boolean.  j must be within	the range 0 <= j <=size, where size
	  is the size, in bits,	of i.  That is,	if i is	a 64-bit object, j
	  must be within the range 0 <=	j <= 64.

     On	UNICOS systems,	an object is 64	bits.  On UNICOS/mk systems, an
     object is 32 bits or 64 bits.  On IRIX systems, an	object is 8 bits,
     16	bits, 32 bits, or 64 bits.

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

NOTES    [Toc]    [Back]

     This is an	outmoded routine.  Refer to the	Fortran	Language Reference
     Manual, Volume 2, publication SR-3903, for	information about outmoded
     features and their	preferred standard alternatives.

     The bit representation of the logical data	type is	not consistent
     among Cray	Research systems.  For further details,	see your compiler's
     reference manuals.

RETURN VALUES    [Toc]    [Back]

     SHIFTR returns a value of type Boolean on UNICOS and UNICOS/mk
     systems.  It returns an integer result on IRIX systems.

EXAMPLES    [Toc]    [Back]

     The following section of Fortran code shows the SHIFTR function used
     in	the case where i is of type integer.  The bit pattern of i and the
     bit pattern of the	result are also	given.	For simplicity,	a 16-bit
     object is used.

	  INTEGER I1, I2, I3
	  ...
	  I2 = 5
	  I3 = SHIFTR(I1,I2)

	   ---------------------------------------------------------------
	  | 1 |	1 | 1 |	1 | 1 |	1 | 1 |	1 | 0 |	0 | 0 |	0 | 0 |	0 | 0 |	0 |
	   ---------------------------------------------------------------
				       I1 (i)

	   ---------------------------------------------------------------
	  | 0 |	0 | 0 |	0 | 0 |	1 | 1 |	1 | 1 |	1 | 1 |	1 | 1 |	0 | 0 |	0 |
	   ---------------------------------------------------------------
				       I3 (result)

SEE ALSO    [Toc]    [Back]

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

[ Back ]
 Similar pages
Name OS Title
shiftl IRIX Performs a left shift with zero fill
shifta IRIX Performs an arithmetic shift
shift IRIX Performs a left circular shift
eoshift IRIX Performs an end-off shift on an array expression
dshiftr IRIX Performs a double-object right shift
cshift IRIX Performs a circular shift on an array expression
dshiftl IRIX Performs a double-object left shift
sem_wait Tru64 Performs (or conditionally performs) a semaphore lock (P1003.1b)
sem_trywait Tru64 Performs (or conditionally performs) a semaphore lock (P1003.1b)
mbsinit Linux test for initial shift state
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service