respect-validation/docs/validators/Undef.md
Alexandre Gomes Gaigalas d9cdc118b2 Introduce REUSE compliance
This commit introduces REUSE compliance by annotating all files
with SPDX information and placing the reused licences in the
LICENSES folder.

We additionally removed the docheader tool which is made obsolete
by this change.

The main LICENSE and copyright text of the project is now not under
my personal name anymore, and it belongs to "The Respect Project
Contributors" instead.

This change restores author names to several files, giving the
appropriate attribution for contributions.
2026-01-21 06:28:11 +00:00

2.2 KiB

Undef

  • Undef()

Validates if the given input is undefined. By undefined we consider null or an empty string ('').

We recommend you to check Comparing empty values for more details.

v::undef()->assert('');
// Validation passes successfully

v::undef()->assert(null);
// Validation passes successfully

Other values similar to undefined values are considered defined:

v::undef()->assert([]);
// → `[]` must be undefined

v::undef()->assert(' ');
// → " " must be undefined

v::undef()->assert(0);
// → 0 must be undefined

v::undef()->assert('0');
// → "0" must be undefined

v::undef()->assert('0.0');
// → "0.0" must be undefined

v::undef()->assert(false);
// → `false` must be undefined

v::undef()->assert(['']);
// → `[""]` must be undefined

v::undef()->assert([' ']);
// → `[" "]` must be undefined

v::undef()->assert([0]);
// → `[0]` must be undefined

v::undef()->assert(['0']);
// → `["0"]` must be undefined

v::undef()->assert([false]);
// → `[false]` must be undefined

v::undef()->assert([[''], [0]]);
// → `[[""], [0]]` must be undefined

v::undef()->assert(new stdClass());
// → `stdClass {}` must be undefined

Templates

Undef::TEMPLATE_STANDARD

Mode Template
default {{subject}} must be undefined
inverted {{subject}} must be defined

Template placeholders

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

Categorization

  • Miscellaneous

Changelog

Version Description
3.0.0 Renamed to Undef and changed the behavior
1.0.0 Created as NotOptional

See also: