《编写高质量Python代码的59个有效方法》——第14条:尽量用异常来表示特殊情况,而不要返回None

简介:

本节书摘来自华章社区《编写高质量Python代码的59个有效方法》一书中的第14条:尽量用异常来表示特殊情况,而不要返回None,作者[美]布雷特·斯拉特金(Brett Slatkin),更多章节内容可以访问云栖社区“华章社区”公众号查看

第14条:尽量用异常来表示特殊情况,而不要返回None
编写工具函数(utility function)时,Python程序员喜欢给None这个返回值赋予特殊意义。这么做有时是合理的。例如,要编写辅助函数,计算两数相除的商。在除数为0的情况下,计算结果是没有明确含义的(undef?ined,未定义的),所以似乎应该返回None。

此函数的调用者,可以对这种特殊的返回值做相应的解读。

分子若是0,会怎么样呢?在那种情况下,如果分母非零,那么计算结果就是0。当在if等条件语句中拿这个计算结果做判断时,会出现问题。我们可能不会专门去判断函数的返回值是否为None,而是会假定:只要返回了与False等效的运算结果,就说明函数出错了(类似的用法,请参见本书第4条)。

如果None这个返回值,对函数有特殊意义,那么在编写Python代码来调用该函数时,就很容易犯上面这种错误。由此可见,令函数返回None,可能会使调用它的人写出错误的代码。有两种办法可以减少这种错误。
第一种办法,是把返回值拆成两部分,并放到二元组(two-tuple)里面。二元组的首个元素,表示操作是否成功,接下来的那个元素,才是真正的运算结果。

调用该函数的人需要解析这个元组。这就迫使他们必须根据元组中表示运算状态的那个元素来做判断,而不能像从前那样,直接根据相除的结果做判断。

问题在于,调用者可以通过以下划线为名称的变量,轻易跳过元组的第一部分(Python程序员习惯用这种写法来表示用不到的变量)。这样写出来的代码,看上去似乎没错,但实际上,却和直接返回None的那种情况有着相同的错误。

第二种办法更好一些,那就是根本不返回None,而是把异常抛给上一级,使得调用者必须应对它。本例中,把ZeroDivisionError转化成ValueError,用以表示调用者所给的输入值是无效的:

现在,调用者就需要处理因输入值无效而引发的异常了(这种抛出异常的行为,应该写入开发文档,参见本书第49条)。调用者无需用条件语句来判断函数的返回值,因为如果函数没有抛出异常,返回值自然就是正确的。这样写出来的异常处理代码,也比较清晰。

要点
用None这个返回值来表示特殊意义的函数,很容易使调用者犯错,因为None和0及空字符串之类的值,在条件表达式里都会评估为False。
函数在遇到特殊情况时,应该抛出异常,而不要返回None。调用者看到该函数的文档中所描述的异常之后,应该就会编写相应的代码来处理它们了。

相关文章
|
2月前
|
存储 算法 调度
【复现】【遗传算法】考虑储能和可再生能源消纳责任制的售电公司购售电策略(Python代码实现)
【复现】【遗传算法】考虑储能和可再生能源消纳责任制的售电公司购售电策略(Python代码实现)
185 26
|
2月前
|
测试技术 开发者 Python
Python单元测试入门:3个核心断言方法,帮你快速定位代码bug
本文介绍Python单元测试基础,详解`unittest`框架中的三大核心断言方法:`assertEqual`验证值相等,`assertTrue`和`assertFalse`判断条件真假。通过实例演示其用法,帮助开发者自动化检测代码逻辑,提升测试效率与可靠性。
323 1
|
2月前
|
机器学习/深度学习 算法 调度
基于多动作深度强化学习的柔性车间调度研究(Python代码实现)
基于多动作深度强化学习的柔性车间调度研究(Python代码实现)
174 1
|
1月前
|
测试技术 Python
Python装饰器:为你的代码施展“魔法”
Python装饰器:为你的代码施展“魔法”
236 100
|
1月前
|
开发者 Python
Python列表推导式:一行代码的艺术与力量
Python列表推导式:一行代码的艺术与力量
370 95
|
2月前
|
Python
Python的简洁之道:5个让代码更优雅的技巧
Python的简洁之道:5个让代码更优雅的技巧
237 104
|
2月前
|
开发者 Python
Python神技:用列表推导式让你的代码更优雅
Python神技:用列表推导式让你的代码更优雅
433 99
|
1月前
|
缓存 Python
Python装饰器:为你的代码施展“魔法
Python装饰器:为你的代码施展“魔法
153 88
|
2月前
|
IDE 开发工具 开发者
Python类型注解:提升代码可读性与健壮性
Python类型注解:提升代码可读性与健壮性
265 102
|
2月前
|
人工智能 数据安全/隐私保护 异构计算
桌面版exe安装和Python命令行安装2种方法详细讲解图片去水印AI源码私有化部署Lama-Cleaner安装使用方法-优雅草卓伊凡
桌面版exe安装和Python命令行安装2种方法详细讲解图片去水印AI源码私有化部署Lama-Cleaner安装使用方法-优雅草卓伊凡
388 8
桌面版exe安装和Python命令行安装2种方法详细讲解图片去水印AI源码私有化部署Lama-Cleaner安装使用方法-优雅草卓伊凡