respect-validation/docs/validators/Spaced.md
Henrique Moody d2198dfd01
Replace isValid() calls with assert()
There's more value on showing how `assert()` displays the validation
messages than simply showing if `isValid()` returns `true` or `false`.

However, that increases the chances of having outdated documentation, so
I created a doc linter that updates the Markdown files with the
correct message.
2026-01-13 23:37:06 -07:00

1.8 KiB

Spaced

  • Spaced()

Validates if a string contains at least one whitespace (spaces, tabs, or line breaks);

v::spaced()->assert('foo bar');
// Validation passes successfully

v::spaced()->assert("foo\nbar");
// Validation passes successfully

This is most useful when inverting the validator as notSpaced(), and chaining with other validators such as Alnum or Alpha to ensure that a string contains no whitespace characters:

v::notSpaced()->alnum()->assert('username');
// Validation passes successfully

v::notSpaced()->alnum()->assert('user name');
// → - "user name" must pass all the rules
// →   - "user name" must not contain whitespaces
// →   - "user name" must contain only letters (a-z) and digits (0-9)

Templates

Spaced::TEMPLATE_STANDARD

Mode Template
default {{subject}} must contain at least one whitespace
inverted {{subject}} must not contain whitespaces

Template placeholders

Placeholder Description
subject The validated input or the custom validator name (if specified).

Categorization

  • Strings

Changelog

Version Description
3.0.0 Renamed to Spaced and changed the behavior
0.3.9 Created as NoWhitespace

See also: