lrotl-lrotr.md

title	description	ms.date	api_name	api_location	api_type	topic_type	f1_keywords	helpviewer_keywords	ms.assetid
_lrotl, _lrotr	API reference for _lrotl and _lrotr; which rotate bits to the left (_lrotl) or right (_lrotr).	04/04/2018	_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	apiref	lrotr lrotl _lrotr _lrotl	lrotl function bits _lrotr function lrotr function rotating bits _lrotl function bits, rotating	d42f295b-35f9-49d2-9ee4-c66896ffe68e

_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's no error return.

Remarks

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

Requirements

Routine	Required header
_lrotl, _lrotr	<stdlib.h>

For more compatibility information, see Compatibility.

Example

// crt_lrot.c

#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   unsigned long val = 0x0fac35791;

   printf( "0x%8.8lx rotated left eight bits is 0x%8.8lx\n",
            val, _lrotl( val, 8 ) );
   printf( "0x%8.8lx rotated right four bits is 0x%8.8lx\n",
            val, _lrotr( val, 4 ) );
}

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

See also

Math and floating-point support
_rotl, _rotl64, _rotr, _rotr64