lrotl-lrotr.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	apiname	apilocation	apitype	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
_lrotl, _lrotr | Microsoft Docs		11/04/2016			cpp-standard-libraries		article	_lrotl _lrotr	msvcrt.dll msvcr80.dll msvcr90.dll msvcr100.dll msvcr100_clr0400.dll msvcr110.dll msvcr110_clr0400.dll msvcr120.dll msvcr120_clr0400.dll ucrtbase.dll api-ms-win-crt-utility-l1-1-0.dll	DLLExport	lrotr lrotl _lrotr _lrotl	C++	lrotl function bits _lrotr function lrotr function rotating bits _lrotl function bits, rotating	d42f295b-35f9-49d2-9ee4-c66896ffe68e	10	corob-msft	corob	ghogen

_lrotl, _lrotr

Rotates bits to the left (_lrotl) or right (_lrotr).

Syntax

  
      unsigned long _lrotl(  
   unsigned long value,  
   int shift   
);  
unsigned long _lrotr(  
   unsigned long value,  
   int shift   
);  

Parameters

value
Value to be rotated.

shift
Number of bits to shift value.

Return Value

Both functions return the rotated value. There is no error return.

Remarks

The _lrotl and _lrotr functions rotate value by shift bits. _lrotl rotates the value left. _lrotr rotates the value right. Both functions wrap bits rotated off one end of value to the other end.

Requirements

Routine	Required header
_lrotl	<stdlib.h>
_lrotr	<stdlib.h>

For more compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

Example

// crt_lrot.c  
  
#include <stdlib.h>  
#include <stdio.h>  
  
int main( void )  
{  
   unsigned long val = 0x0fac35791;  
  
   printf( "0x%8.8lx rotated left eight times is 0x%8.8lx\n",   
            val, _lrotl( val, 8 ) );  
   printf( "0x%8.8lx rotated right four times is 0x%8.8lx\n",   
            val, _lrotr( val, 4 ) );  
}  

Output

0xfac35791 rotated left eight times is 0xc35791fa  
0xfac35791 rotated right four times is 0x1fac3579  

See Also

Floating-Point Support
_rotl, _rotl64, _rotr, _rotr64