bits rol: Bitwise Rotate Left

1st chunk of `commands/docs/bits_rol.md`

a2b847c671f1a930618ef470cc18940ccb69acda03aa2fe400000001000005b3

---
title: bits rol
categories: |
  bits
version: 0.104.0
bits: |
  Bitwise rotate left for ints or binary values.
usage: |
  Bitwise rotate left for ints or binary values.
editLink: false
contributors: false
---
<!-- This file is automatically generated. Please edit the command in https://github.com/nushell/nushell instead. -->

# `bits rol` for [bits](/commands/categories/bits.md)

<div class='command-title'>Bitwise rotate left for ints or binary values.</div>

## Signature

```> bits rol {flags} (bits)```

## Flags

 -  `--signed, -s`: always treat input number as a signed number
 -  `--number-bytes, -n {int}`: the word size in number of bytes, it can be 1, 2, 4, 8, auto, default value `8`

## Parameters

 -  `bits`: Number of bits to rotate left.


## Input/output types:

| input        | output       |
| ------------ | ------------ |
| binary       | binary       |
| int          | int          |
| list\<binary\> | list\<binary\> |
| list\<int\>    | list\<int\>    |
## Examples

Rotate left a number with 2 bits
```nu
> 17 | bits rol 2
68
```

Rotate left a list of numbers with 2 bits
```nu
> [5 3 2] | bits rol 2
╭───┬────╮
│ 0 │ 20 │
│ 1 │ 12 │
│ 2 │  8 │
╰───┴────╯

```

rotate left binary data
```nu
> 0x[c0 ff ee] | bits rol 10
Length: 3 (0x3) bytes | printable whitespace ascii_other non_ascii
00000000:   ff bb 03                                             ××•

```

Title: bits rol: Bitwise Rotate Left

Summary

The `bits rol` command performs a bitwise rotate left operation on integers or binary values. It accepts the number of bits to rotate as a parameter and can handle single values or lists of values. The command also offers flags to specify signedness and word size.