请根据题目给出的要求，编写与之相匹配的 Python 函数。

回答思路

1. 【回答框架 1】先仔细阅读题目要求，明确函数的功能、输入参数和返回值类型，以及可能的边界条件。
2. 【回答框架 2】根据要求设计算法逻辑，选择合适的控制流和数据结构来实现功能。
3. 【回答框架 3】编写函数代码，注意命名规范，添加必要的注释说明关键步骤。
4. 【回答框架 4】考虑异常情况，如输入参数为 None、空值或特殊值时的处理方式。
5. 【回答框架 5】最后用示例输入测试函数，验证输出是否符合预期。
6. 【关键点 1】明确函数输入输出及功能。
7. 【关键点 2】正确处理边界与特殊输入。
8. 【关键点 3】代码实现规范，可读性强。
9. 【关键点 4】使用示例验证逻辑正确性。
10. 【易错点 1】忽略输入参数的类型检查，可能导致运行时错误。
11. 【易错点 2】未考虑空值或极限情况，使程序崩溃。
12. 【易错点 3】代码冗长，缺乏注释，降低可维护性。