Generate Function (production-ready)

Write a complete, production-ready function: **Language:** [[LANGUAGE]] **Function name:** [[FUNCTION_NAME]] **Task:** [[DESCRIPTION]] **Parameters:** [[PARAMETERS]] **Return value:** [[RETURN_VALUE]] Requirements: - Complete JSDoc/Docstring documentation - Input validation and error handling - At least 2 usage examples - Notes on possible edge cases - Time complexity (O-notation)Copy