mirror of https://github.com/Respect/Validation.git synced 2026-03-16 15:25:45 +01:00

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.3 KiB

Raw Blame History

ContainsCount

ContainsCount(mixed $containsValue, int $count)
ContainsCount(mixed $containsValue, int $count, bool $identical)

Validates if the input contains a value a specific number of times.

For strings:

v::containsCount('ipsum', 2)->assert('ipsum lorem ipsum');
// Validation passes successfully

For arrays:

v::containsCount('ipsum', 2)->assert(['ipsum', 'lorem', 'ipsum']);
// Validation passes successfully

A third parameter may be passed for identical comparison instead of equal comparison.

v::containsCount(1, 1, true)->assert([1, 2, 3]);
// Validation passes successfully

v::containsCount('1', 1, true)->assert([1, 2, 3]);
// → `[1, 2, 3]` must contain "1" only once

Templates

`ContainsCount::TEMPLATE_TIMES`

Mode	Template
`default`	{{subject}} must contain {{containsValue}} {{count}} time(s)
`inverted`	{{subject}} must not contain {{containsValue}} {{count}} time(s)

`ContainsCount::TEMPLATE_ONCE`

Mode	Template
`default`	{{subject}} must contain {{containsValue}} only once
`inverted`	{{subject}} must not contain {{containsValue}} only once

Template placeholders

Placeholder	Description
`containsValue`	The value to search for in the input.
`subject`	The validated input or the custom validator name (if specified).
`count`	Number of times that the needle might appear in the haystack.

Categorization

Arrays
Strings

Changelog

Version	Description
3.0.0	Created

2.3 KiB Raw Blame History