> ## 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.
# PHP Subtraction Assignment
The `-=` operator is a compound assignment operator in PHP that subtracts the value of the right operand from the left operand and assigns the resulting value back to the left operand.
## Syntax
```php theme={"dark"}
$variable -= expression;
```
While functionally equivalent to the expanded assignment form (`$variable = $variable - expression;`), the `-=` operator evaluates the left-hand side exactly once. If the left operand is an expression with side effects—such as an array index determined by a function call—the compound assignment executes the function only once. In contrast, the expanded form would evaluate the function twice.
## Technical Characteristics
* **L-value Requirement:** The left operand must be a valid variable reference (an l-value) capable of receiving an assignment.
* **Type Coercion and Promotion:** The operator expects numeric operands (integers or floats).
* If an integer and a float are used, the integer is implicitly promoted to a float during the arithmetic operation, resulting in a float.
* If a numeric string is provided, PHP performs implicit type juggling to convert the string to an integer or float before subtraction.
* In PHP 8.0 and later, passing a non-numeric string or incompatible type will throw a `TypeError`.
* **Return Value:** Like all assignment operators in PHP, `-=` evaluates to the newly assigned value. This allows the operation to be embedded within larger expressions or chained.
## Mechanical Examples
```php theme={"dark"}
// Standard integer subtraction assignment
$a = 10;
$a -= 4;
// $a is now 6 (int)
// Implicit float promotion
$b = 5;
$b -= 2.5;
// $b is now 2.5 (float)
// Right operand expression evaluation
$c = 20;
$c -= (2 * 3);
// $c is now 14 (int)
// Implicit type juggling (numeric string)
$d = 15;
$d -= "5";
// $d is now 10 (int)
// Return value evaluation
$e = 10;
$f = ($e -= 3);
// $e is 7, $f is 7
// Single evaluation of the left-hand side
function get_index() {
return 1;
}
$array = [10, 20, 30];
$array[get_index()] -= 5;
// get_index() is called exactly once. $array[1] is now 15.
```
Tired of Poor PHP Skills? Fix That With Deep Grasping!
Learn More
