> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Python Left Shift Assignment
The `<<=` operator is the bitwise left shift assignment operator in Python. It shifts the binary representation of the left operand to the left by the number of bits specified by the right operand, and assigns the resulting value back to the left operand.
```python theme={"dark"}
x <<= y
```
This operation is functionally equivalent to:
```python theme={"dark"}
x = x << y
```
## Mechanics
When the `<<=` operator is applied, the following technical behaviors occur:
1. **Bit Manipulation:** The binary bits of the left operand are shifted to the left. For every position shifted, a `0` is appended to the least significant bit (right side).
2. **Arbitrary Precision:** Unlike languages with fixed-width integers (e.g., C or Java), Python's `int` type has arbitrary precision. Therefore, shifting left will never cause an arithmetic overflow or truncate the most significant bits. The bit-length of the integer simply grows to accommodate the new magnitude.
3. **Mathematical Equivalence:** Shifting an integer left by `y` positions is mathematically identical to multiplying the integer by $2^y$.
4. **Operand Constraints:** The right operand (`y`) must be a non-negative integer. If `y` is negative, Python raises a `ValueError: negative shift count`. Both operands must be integers; using floats or other types raises a `TypeError`.
## Object Model Implementation
Under the hood, the `<<=` operator invokes the in-place left shift magic method (dunder method).
When `x <<= y` is executed, Python attempts to call:
```python theme={"dark"}
x.__ilshift__(y)
```
If the left operand's class does not implement `__ilshift__`, Python falls back to the standard left shift method and reassigns the result:
```python theme={"dark"}
x = x.__lshift__(y)
```
## Execution Examples
```python theme={"dark"}
# Base integer assignment
x = 5 # Binary: 101
x <<= 3 # Shift left by 3 bits. Binary becomes: 101000
print(x) # Output: 40 (Equivalent to 5 * 2^3)
# Negative integer assignment
y = -7
y <<= 2
print(y) # Output: -28 (Equivalent to -7 * 2^2)
# Zero assignment
z = 0 # Binary: 0
z <<= 5 # Shift left by 5 bits. Binary remains: 0
print(z) # Output: 0
```
Tired of Poor Python Skills? Fix That With Deep Grasping!
Learn More
