python3 函数参数总结

一、具体说明看函数调用，说明很清晰。

"""
函数参数
"""
import pysnooper


@pysnooper.snoop()
def tag(name, *content, cls=None, **attrs):
     """
     生成一个或多个HTML标签
     """

     if cls is not None:
        attrs['class'] = cls

     if attrs:
        attr_str = ''.join(' %s="%s"' % (attr, value) for attr, value in sorted(attrs.items()))

     else:
        attr_str = ''

     if content:
        return '\n'.join('<%s%s>%s</%s>' % (name, attr_str, c, name) for c in content)

     else:
        return '<%s%s />' % (name, attr_str)


if __name__ == '__main__':
    # 传入单个定位参数，生成一个指定名称的空标签。
    print(tag('br'))
    
    # 第一个参数后面的任意个参数会被*content捕获，存入一个元组。
    print(tag('p', 'hello'))
    print(tag('p', 'hello', 'world'))
    
    # tag函数签名中没有明确指定名称的关键字参数会被 ** attrs捕获，存入一个字典
    print(tag('p', 'hello', id=33))
    
    # cls参数只能作为关键字参数传入
    print(tag('p', 'hello', 'world', cls='sidebar'))
    
    # 调用tag函数时，即便第一个定位参数也能作为关键字参数传入。
    print(tag(content='testing', name="img"))
    
    my_tag = {
        'name': 'img',
        'title': 'Sunset Boulevard',
        'src': 'sunset.jpg',
        'cls': 'framed'
    }
    # 在my_tag前面加上**，字典中的所有元素作为单个参数传入，同名键会绑定到对应的具名参数上，余下的则被**attrs捕获
    print(tag(**my_tag))

二、注意（参数定义的顺序问题）
仅限关键字参数是Python 3新增的特性。在上面事例中，cls参数只能通过关键字参数指定，它一定不会捕获未命名的定位参数。定义函数时若想指定仅限关键字参数，要把它们放到前面有*的参数后面。如果不想支持数量不定的定位参数，但是想支持仅限关键字参数，在签名中放一个*，如下所示：

def f(a, *, b):
    return a, b


if __name__ == '__main__':
	print(f(4, b=5))