Files
anb_python_components/help/class_desc/extensions/bool_extension.md
2025-10-03 18:35:32 +03:00

3.7 KiB
Raw Blame History

Класс BoolExtension

Этот класс предназначен для предоставления расширенных возможностей работы с булевыми значениями в Python. Класс обеспечивает удобные способы конвертации булевых значений в строки, подсчета количества истинных элементов в списках и обнаружения наличия хотя бы одного истинного элемента среди списка выражений.

Основная информация

  • Имя файла: anb_python_components/extensions/bool_extension.py
  • Автор: Александр Бабаев
  • Версия: 1.0.0
  • Дата начала поддержки: с версии 1.0

Атрибуты и методы класса

Метод to_str

Конвертирует булево значение в строку, используя кастомизированные обозначения для значений True и False.

Параметры:

  • b: Булево значение, которое необходимо преобразовать.
  • if_true: Значение, которое возвращается, если булево значение равно True (по умолчанию "True").
  • if_false: Значение, которое возвращается, если булево значение равно False (по умолчанию "False").

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

from anb_python_components.extensions.bool_extension import BoolExtension

print(BoolExtension.to_str(True))  # True
print(BoolExtension.to_str(False, if_false="Нет"))  # Нет

Метод true_count

Подсчитывает количество истинных значений в списке выражений, предлагая разные подходы к обработке не-булевых значений.

Параметры:

  • expressions: Список булевых выражений.
  • if_not_bool: Параметр, определяющий стратегию обработки небулевых значений. По умолчанию игнорируются. Стратегии обработки небулевых значений определяются перечислением NotBoolAction.

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

from anb_python_components.enums.not_bool_action import NotBoolAction
from anb_python_components.extensions.bool_extension import BoolExtension

expressions = [True, False, "Некорректное значение"]
count = BoolExtension.true_count(expressions, NotBoolAction.IT_TRUE)
print(count)  # 2

Метод any_true

Проверяет, присутствует ли хотя бы одно истинное выражение в списке.

Параметры:

  • expressions: Список булевых выражений.

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

from anb_python_components.extensions.bool_extension import BoolExtension

expressions = [False, False, True]
result = BoolExtension.any_true(expressions)
print(result)  # True

Заключение

Класс BoolExtension существенно облегчает работу с булевыми значениями, предоставляя удобную обработку нестандартных ситуаций и простое управление потоком логики в приложении.

На главную