respect-validation/docs/rules/IntVal.md
Henrique Moody 48405271c5
Replace placeholder "name" with "subject"
The `{{name}}` placeholder could represent different things depending on
the state of the Result, and referring to it as `{{name}}` seems
arbitrary. This commit changes it to `{{subject}}`, which is much more
generic and it describes well what that placeholder can mean.
2025-12-26 21:30:01 +01:00

68 lines
1.9 KiB
Markdown

# IntVal
- `IntVal()`
Validates if the input is an integer, allowing leading zeros and other number bases.
```php
v::intVal()->isValid('10'); // true
v::intVal()->isValid('089'); // true
v::intVal()->isValid(10); // true
v::intVal()->isValid(0b101010); // true
v::intVal()->isValid(0x2a); // true
```
This rule will consider as valid any input that PHP can convert to an integer,
but that does not contain non-integer values. That way, one can safely use the
value this rule validates, without having surprises.
```php
v::intVal()->isValid(true); // false
v::intVal()->isValid('89a'); // false
```
Even though PHP can cast the values above as integers, this rule will not
consider them as valid.
## Templates
### `IntVal::TEMPLATE_STANDARD`
| Mode | Template |
| ---------- | ---------------------------------------- |
| `default` | {{subject}} must be an integer value |
| `inverted` | {{subject}} must not be an integer value |
## Template placeholders
| Placeholder | Description |
| ----------- | ---------------------------------------------------------------- |
| `subject` | The validated input or the custom validator name (if specified). |
## Categorization
- Numbers
- Types
## Changelog
| Version | Description |
| ------: | --------------------------------------------------------- |
| 2.2.4 | Improved support for negative values with trailing zeroes |
| 2.0.14 | Allow leading zeros |
| 1.0.0 | Renamed from `Int` to `IntVal` |
| 0.3.9 | Created as `Int` |
---
See also:
- [Decimal](Decimal.md)
- [Digit](Digit.md)
- [Finite](Finite.md)
- [FloatType](FloatType.md)
- [FloatVal](FloatVal.md)
- [Infinite](Infinite.md)
- [IntType](IntType.md)
- [NumericVal](NumericVal.md)
- [Type](Type.md)