Python函数参数与注释

发表于 | 更新于 | 评论数： | 阅读次数：

Python函数参数

Python的函数具有非常灵活的参数形态，既可以实现简单的调用，又可以传入非常复杂的参数。

默认参数一定要用不可变对象，如果是可变对象，程序运行时会有逻辑错误！

要注意定义可变参数和关键字参数的语法：

*args是可变参数，args接收的是一个tuple；

**kw是关键字参数，kw接收的是一个dict。

以及调用函数时如何传入可变参数和关键字参数的语法：

可变参数既可以直接传入：func(1, 2, 3)，又可以先组装list或tuple，再通过args传入：func((1, 2, 3))；

关键字参数既可以直接传入：func(a=1, b=2)，又可以先组装dict，再通过kw传入：func({‘a’: 1, ‘b’: 2})。

Python函数注释

  • Google风格
1
2
3
4
5
6
7
8
9
10
11
12
13
"""
This is a groups style docs.
 
Parameters:
  param1 - this is the first param
  param2 - this is a second param
 
Returns:
    This is a description of what is returned
 
Raises:
    KeyError - raises an exception
"""
  • Rest风格
1
2
3
4
5
6
7
8
"""
This is a reST style.
 
:param param1: this is a first param
:param param2: this is a second param
:returns: this is a description of what is returned
:raises keyError: raises an exception
"""

参考链接

  1. 函数的参数,by 廖雪峰.
  2. Python3 - 6种方法拼接合并列表（list）,by Mediumcn.
  3. python函数注释,by 戴思达.