respect-validation/docs/validators/ContainsCount.md
Alexandre Gomes Gaigalas bd48bdcda4 Lint Changelog format in validator docs
Introduces a Markdown linter for checking the Changelog format.

"See Also" was transformed into a section to make it easier to
handle it with the `Content` class. The "Related" linter was
simplified to reflect that change too.

An additional "alignment" parameter was added to markdown table
generators, allowing the padding and headers to be explicitly
marked with a specific left (-1), middle (0) or right(1)
alignment.

Existing files were fixed using the `fix` option after the
changes.
2026-01-26 19:11:00 +00:00

2.3 KiB

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

See Also