《编写高质量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。调用者看到该函数的文档中所描述的异常之后,应该就会编写相应的代码来处理它们了。

相关文章
|
7天前
|
Python
python魔法方法如何应用
【4月更文挑战第12天】这个Python示例展示了类继承和方法重写。`Student`类继承自`Person`,并覆盖了`say_hello`方法。通过`super().__init__(name)`调用父类的`__init__`初始化`name`属性,`Student`添加了`age`属性,并在重写的`say_hello`中使用。创建`Student`实例`student`并调用其`say_hello`,输出定制的问候信息。
19 1
|
9天前
|
监控 Python
Python中的装饰器:提升代码灵活性与可读性
在Python编程中,装饰器是一种强大的工具,能够提升代码的灵活性和可读性。本文将介绍装饰器的基本概念、使用方法以及实际应用场景,帮助读者更好地理解和利用这一功能。
|
10天前
|
缓存 监控 算法
优化Python代码性能的10个技巧
提高Python代码性能是每个开发者都需要关注的重要问题。本文将介绍10个实用的技巧,帮助你优化Python代码,提升程序的运行效率和性能表现。无论是避免内存泄漏、减少函数调用次数,还是使用适当的数据结构,都能在不同场景下发挥作用,使你的Python应用更加高效稳定。
|
1天前
|
存储 关系型数据库 MySQL
Python搭建代理IP池实现存储IP的方法
Python搭建代理IP池实现存储IP的方法
|
1天前
|
Python
Python动态IP代理防止被封的方法
Python动态IP代理防止被封的方法
|
1天前
|
数据采集 存储 安全
python检测代理ip是否可用的方法
python检测代理ip是否可用的方法
|
2天前
|
数据安全/隐私保护 Python
Python中的装饰器:提升代码可读性与灵活性
Python中的装饰器是一种强大的工具,可以在不改变函数原有逻辑的情况下,为函数添加额外的功能。本文将介绍装饰器的基本概念和用法,并通过实例演示如何利用装饰器提升代码的可读性和灵活性,使代码更加简洁、易于维护。
|
2天前
|
BI 开发者 数据格式
Python代码填充数据到word模板中
【4月更文挑战第16天】
|
2天前
|
数据可视化 测试技术 Python
在Python和R中使用交叉验证方法提高模型性能
在Python和R中使用交叉验证方法提高模型性能
|
3天前
|
存储 监控 开发工具
对象存储OSS产品常见问题之python sdk中的append_object方法支持追加上传xls文件如何解决
对象存储OSS是基于互联网的数据存储服务模式,让用户可以安全、可靠地存储大量非结构化数据,如图片、音频、视频、文档等任意类型文件,并通过简单的基于HTTP/HTTPS协议的RESTful API接口进行访问和管理。本帖梳理了用户在实际使用中可能遇到的各种常见问题,涵盖了基础操作、性能优化、安全设置、费用管理、数据备份与恢复、跨区域同步、API接口调用等多个方面。
34 9