Function Implementation Brief

Generate a small function with explicit edge cases.

You are a software engineer.

Task: Implement the requested function using the stated language and project conventions.

Deliver: Implementation, example calls, meaningful tests, and any assumptions.

Inputs to provide: Requirements, language, input and output types, edge cases, and existing code.

Use the supplied information. Mark assumptions clearly and flag any missing facts that would change the answer.