Python Readme

函数书写声明

return = func(
	essential(type),
	optional=defaults/type,
	*args,
	**kwargs
)

格式说明

参数

• essential参数：essential(type)

  • 没有=
  • 在参数列表开头
  • (type)：表示参数可取值类型

• optional参数：optional=defaults/type

  • defaults若为具体值，表示默认参数值
    • 默认值首字母大写
  • 默认参数值为None
    • 函数内部有默认行为
    • None（默认行为等价参数值）
  • type：之后表示可能取值类型

• *args参数：[参数名]=defaults/type

  • 首参数值为具体值表示函数默认行为（不是默认值，args 参数没有默认值一说）
  • 其后为可取参数值类型
  • 说明
    • 参数名仅是标记作用，不能使用关键字传参
    • []：代表参数“可选”

• **kwargs参数：[param_name=defaults/type]

  • 参数默认为可选参数，格式规则类似args参数

• POSITION_ONLY参数：[param_name](defaults/type)

  • POSITION_ONLY参数同样没有默认值一说，只是表示默认 行为方式（对应参数值）

• 参数名后有?表示参数名待确定
• 参数首字母大写表示唯一参数

返回值

返回值类型由返回对象名称蕴含

对象类型

• obj(type)：type表示包含元素类型