respect-validation/docs/rules/Xdigit.md
Henrique Moody be72a54845
Add templates to each rule documentation
They only know what message a rule produces when they try running it.
Including the messages in the documentation will make it easier for
people to know what to expect.

There are a couple of undocumented placeholders, but I can live with
that for now.
2024-12-06 00:21:47 +01:00

57 lines
1.6 KiB
Markdown

# Xdigit
- `Xdigit()`
- `Xdigit(string ...$additionalChars)`
Validates whether the input is an hexadecimal number or not.
```php
v::xdigit()->isValid('abc123'); // true
```
Notice, however, that it doesn't accept strings starting with 0x:
```php
v::xdigit()->isValid('0x1f'); // false
```
## Templates
`Xdigit::TEMPLATE_STANDARD`
| Mode | Template |
|------------|---------------------------------------------------|
| `default` | {{name}} must only contain hexadecimal digits |
| `inverted` | {{name}} must not only contain hexadecimal digits |
`Xdigit::TEMPLATE_EXTRA`
| Mode | Template |
|------------|---------------------------------------------------------------------|
| `default` | {{name}} must contain hexadecimal digits and {{additionalChars}} |
| `inverted` | {{name}} must not contain hexadecimal digits or {{additionalChars}} |
## Template placeholders
| Placeholder | Description |
|-------------------|------------------------------------------------------------------|
| `additionalChars` | Additional characters that are considered valid. |
| `name` | The validated input or the custom validator name (if specified). |
## Categorization
- Strings
## Changelog
| Version | Description |
|--------:|-------------|
| 0.5.0 | Created |
***
See also:
- [Alnum](Alnum.md)
- [Decimal](Decimal.md)
- [Digit](Digit.md)
- [HexRgbColor](HexRgbColor.md)