babaev-an / ANB PHP COMPONENTS PACK

extensions/BoolExtensions.md

Класс BoolExtensions

Пространство имён: goodboyalex\php_components_pack\extensions
Версия: 1.2
Доступно с: 1.0.7

Описание

Класс предоставляет дополнительные методы для работы с булевыми значениями, расширяющие стандартный функционал PHP.

Автор и метаданные

  • Имя: Александр Бабаев

Методы класса

exportToString

public static function exportToString(bool $b, string $ifTrue = "true", string $ifFalse = "false"): string

Описание: Преобразует булево значение в строку.

Параметры:

  • $b (bool) — проверяемое булево значение
  • $ifTrue (string) — строка для истинного значения (по умолчанию “true”)
  • $ifFalse (string) — строка для ложного значения (по умолчанию “false”)

Возвращаемое значение:

  • string — результат преобразования

Пример использования:

echo BoolExtensions::exportToString(true); // Выведет "true"
echo BoolExtensions::exportToString(false, 'Да', 'Нет'); // Выведет "Нет"

anyTrue

public static function anyTrue(array $expressions, VarNotBoolAction $ifNotBool = VarNotBoolAction::Ignore): bool

Описание: Проверяет, есть ли хотя бы одно истинное значение в массиве.

Параметры:

  • $expressions (array) — массив проверяемых значений
  • $ifNotBool (VarNotBoolAction) — действие при обнаружении не-булевого значения

Возвращаемое значение:

  • bool — true, если есть хотя бы одно истинное значение

Пример использования:

$values = [true, false, null];
echo BoolExtensions::anyTrue($values); // Выведет true

trueCount

public static function trueCount(array $expressions, VarNotBoolAction $ifNotBool = VarNotBoolAction::Ignore): int

Описание: Подсчитывает количество истинных значений в массиве.

Параметры:

  • $expressions (array) — массив проверяемых значений
  • $ifNotBool (VarNotBoolAction) — действие при обнаружении не-булевого значения

Возвращаемое значение:

  • int — количество истинных значений

Пример использования:

$values = [true, false, true, 'string'];
echo BoolExtensions::trueCount($values, VarNotBoolAction::ConsiderItFalse); // Выведет 2

isValueSelected

public static function isValueSelected (mixed $current, mixed $verifiable): bool

Описание: Проверяет, является ли значение выбранным.

Параметры:

  • $current (mixed) - текущее значение;
  • $verifiable (mixed) - проверяемое значение.

Возвращаемое значение:

  • bool — Результат проверки.

Пример использования:

$values = [0, null, 1, '0'];
foreach ($values as $value) 
    echo BoolExtensions::isValueSelected(0, $value) == true ? '1 ' : '0 ';

// Вывод
// 1 0 0 1

Особенности работы

  • Методы статические — не требуют создания экземпляра класса
  • Поддерживают различные стратегии обработки не-булевых значений
  • Предоставляют гибкие возможности форматирования

Рекомендации по использованию

  1. При преобразовании в строку:

    • Используйте exportToString() для кастомного форматирования
    • Укажите нужные строки для true/false

  2. При проверке массивов:

    • Укажите стратегию обработки не-булевых значений
    • Используйте anyTrue() для быстрой проверки наличия true
    • Используйте trueCount() для подсчета истинных значений

На главную | Содержание

Назад