Python编程:从入门到实践第八章读书笔记8.7函数编写指南
#coding:gbk
#函数编写的几个细节:
# 1.应该给函数指定描述性名称,且只在其中使用小写字母和下划线。
# 描述性名称可帮助你和别人明白代码想要做什么。给模块命名时也应遵循这个约定。
# 2.每个函数都应该包含简要地阐述其功能的注释,该注释应紧跟在函数定义后面,并采用文档字符串格式。
# 文档良好的函数让其他程序员只需阅读文档字符串中的描述就能够使用它:他们完全可以相信代码如描述那样运行;
# 只要知道函数的名称、需要的实参以及返回值的类型,就能在自己的程序中使用它。
#其他细节:
# 给形参指定默认值时,等号两边不要有空格:
# def function_name(parameter_0,parameter_1='default value')
# 对于函数调用中的关键字实参,夜莺遵循这种约定:
# function_name(value_0, parameter_1='value')
#代码行的长度不要超过79字符,这样只要编辑器窗口适中,救恩能够看到正行代码。
#如果形参很多导致函数定义的长度超过了79字符,可在函数定义中输入左括号后按回车键,并在下一行按两次tab键,从而将形参列表和只缩进一层的函数体区分开来。
#如果程序或模块包含多个函数,可使用两个空行将相邻的函数分开,这样将更容易知道前一个函数在什么地方结束,下一个函数从什么地方开始
#所有的import语句都应放在文件开头,唯一列外的情形是,在文件开头使用了注释来描述整个程序。