Python中的函数注释:参数有冒号,声明后有-> 箭头

我在查看python的fixture源码时发现 fixture的方法定义形式如下:

def fixture(
    fixture_function: Optional[_FixtureFunction] = None,
    *,
    scope: "Union[_Scope, Callable[[str, Config], _Scope]]" = "function",
    params: Optional[Iterable[object]] = None,
    autouse: bool = False,
    ids: Optional[
        Union[
            Iterable[Union[None, str, float, int, bool]],
            Callable[[Any], Optional[object]],
        ]
    ] = None,
    name: Optional[str] = None,
) -> Union[FixtureFunctionMarker, _FixtureFunction]:

我顿时有些凌乱,不知这是什么东东,经过各种网上查找资料,发现这是Python 3.X新增加的一个特性,叫作函数注释 Function Annotations。它的用途虽然不是语法级别的硬性要求,但是顾名思义,它可作为函数额外的注释来用。他的用法也很简单。

在python中定义普通的函数,方法如下:

def f1(a,b):
    return a+b

通过函数注释,方法定义如下:

def f2(a: "str类型参数a", b: "str类型参数b") -> str:
    print("Annotations:", f2.__annotations__)
    return a+b

其中

a: "str类型参数a"代表了对参数a的说明

b: "str类型参数b"代表了对参数b的说明

-> str:代表了函数的返回值

f2.__annotations__查看函数的注释说明

运行 print(f2('aa','bb')),输出:

Annotations: {'a': 'str类型参数a', 'b': 'str类型参数b', 'return': <class 'str'>}

aabb

那么定义了函数的参数类型和返回值类型我们是否就不可以对其进行修改了呢,让我们做如下尝试:

print(f2(1,2)),输出:

Annotations: {'a': 'str类型参数a', 'b': 'str类型参数b', 'return': <class 'str'>}

3

可见, Function Annotations它的作用仅仅是为函数进行注释来用,并不能指定参数类型。

相关文章

python入门到脱坑—Python注释详解

注释是代码中不可或缺的部分,它能提高代码的可读性和可维护性。Python支持多种注释方式,各有其适用场景。一、单行注释1. 基本单行注释使用 # 符号,从 # 开始到行尾的内容都会被解释器忽略# 这是...

Python代码中的注释是什么?

Python 中的注释是什么? 解释器在程序运行时忽略的 Python 代码行称为注释。注释是程序中未执行的一行文本。Python 代码可以用注释来解释。通过添加注释可以使代码更易于阅读。Python...

Python 注释

在Python中,注释用于提供代码的额外信息,帮助开发者理解代码的功能、目的和工作方式。注释不会被Python解释器执行,因此它们不会影响程序的运行。注释的主要用途包括: 1. 解释代码:注释可以解释...

Python注释(多行注释和单行注释)用法详解

注释(Comments)用来向用户提示或解释某些代码的作用和功能,它可以出现在代码中的任何位置。Python解释器在执行代码时会忽略注释,不做任何处理,就好像它不存在一样。在调试(Debug)程序的过...

Python函数调用常见的8个错误及解决方案

一、参数传递错误1. 参数数量不匹配错误示例:def greet(name, age): print(f"{name} is {age} years old") greet(...