一、NotSpecified简介
NotSpecified是Python3.10版本引入的一个新参数值。这个参数值定义在types模块中，可以作为函数、方法或者类的参数默认值。它的作用是告诉Python解释器，这个参数的设定不重要，可以在需要的时候再设定。同时，该参数的存在也能够提高函数参数的可读性和可维护性。
二、NotSpecified的应用场景
1、过时参数的替代
有时候，某个函数中的参数被废弃了，不再推荐使用，但为了保持兼容性，还需要保留该参数的接口。此时，可以使用NotSpecified作为该参数的默认值，表示该参数可以不被设置或者其它参数值可以被传递进去，从而保证了代码的兼容性。
def foo(a, b, c=NotSpecified):
if c is NotSpecified:
warnings.warn("the parameter 'c' is deprecated and will be removed in future releases", DeprecationWarning)
# 不采用默认值NotSpecified，程序会报错
# ...
2、高可读性与可维护性
使用NotSpecified作为默认值，能够使代码更加易读，因为它说明了该参数是一个可选参数，可以不设置。同时，由于其定义作用，该参数也能够更好地与函数的其它部分解耦合。
def foo(a, b, c=NotSpecified):
# 避免在函数体直接使用默认值NotSpecified
if c is NotSpecified:
# ...
三、NotSpecified的局限
作为一种参数默认值类型，NotSpecified也有其局限性。例如，如果使用NotSpecified作为参数的默认值，会影响函数参数的注释以及IDE的自动补全等功能。此外，在默认值为NotSpecified的情况下，如果该参数的类型需要是必须设置的，那么可以使用传统的默认值（例如“None”）。
四、NotSpecified的底层实现
NotSpecified的实现非常简单，它只是一个空的 sentinel 实例。它定义在types模块中，可以通过types.NotSpecified进行使用。此外，该模块还开放了sentinel、_GeneratorWrapper、CoroutineWrapper三个特殊的 sentinel 对象，这些对象都是类似于布尔值的单例对象，用于标识没有数据的情况，增强了Python的可读性和可维护性。
import types
def foo(a, b, c=types.NotSpecified):
if c is types.NotSpecified:
print("The parameter 'c' is not set.")
foo(1, 2)
# 输出：The parameter 'c' is not set.
foo(1, 2, 3)
# 没有输出
五、NotSpecified使用的注意事项
在使用NotSpecified的时候需要注意，因为NotSpecified定义的参数值不等同于一般默认值的None。所以如果没有特别需要，建议在函数体内进行判断，以便更好地避免BUG。
六、总结
在Python3.10版本中引入的NotSpecified参数默认值，可以方便地解决函数中旧参数的替换以及提高代码的可读性和可维护性。但是它需要更多的注意力来避免因参数采用默认NotSpecified引起的问题。
原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/185740.html
微信扫一扫 
支付宝扫一扫 