Промпт для программистов: Создание функций

Создай [ЯЗЫК] функцию со следующими характеристиками:Назначение: [ПОДРОБНОЕ ОПИСАНИЕ ФУНКЦИИ]Входные параметры: [ПАРАМЕТРЫ С ТИПАМИ]Возвращаемое значение: [ТИП И ОПИСАНИЕ]Обработка ошибок: [ТИПЫ ОШИБОК]Дополнительные требования:- Производительность: [ТРЕБОВАНИЯ К ПРОИЗВОДИТЕЛЬНОСТИ]- Безопасность: [ТРЕБОВАНИЯ БЕЗОПАСНОСТИ]- Совместимость: [ВЕРСИИ/ПЛАТФОРМЫ]Включи:- Полную реализацию с docstring- Валидацию входных параметров- Обработку краевых случаев- Примеры использования- Unit-тесты