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

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