Generate a Function

Context: [Language/framework] project, [describe the codebase style/conventions]

Objective: Write a function that [describe what it should do]

Details:
- Input: [describe parameters and types]
- Output: [describe return value and type]
- Edge cases to handle: [list them]
- Should/should not: [any specific requirements]

Example usage:
[Show how the function would be called]

Expected output:
[Show what results you expect]