Escrever função específica

Escreva uma função em [LINGUAGEM] que faça o seguinte: [DESCRIÇÃO DA FUNCIONALIDADE]. Entradas: [ENTRADAS]. Saída esperada: [SAÍDA]. Inclua tratamento de casos extremos (edge cases), comentários explicativos e um exemplo de uso. Siga as boas práticas da linguagem.