大家好,欢迎来到IT知识分享网。
程序里有很多东西需要命名,
良好的命名习惯可以提高编程效率; 减少出错;
良好命名的程序清晰易读。
好的名称可以提供很多有价值的信息。
本文解释作者在《Python编程基础及应用》一书中所使用的命名规则。
知识产权协议
允许以教育/培训为目的向学生或受众进行免费引用,展示或者讲述,无须取得作者同意。 不允许以电子/纸质出版为目的进行摘抄或改编。 |
命名示例
变量、类的数据成员 |
iSum sName fPrice |
函数名称 |
add( ) convert( ) del( ) empty( ) push_back( ) pop( ) |
getPrice( ) setPrice( ) draw( ) render( ) repaint( ) |
类型名称 |
Student GraphDrawer Campus Engine |
FloatBuffer Lesson Monitor Printer EMailPacket |
正确, 错误 vs 好,相对不好, 坏
只要符合所用语言的命名规则的命名原则上都是“正确”的。 不同的人有不同的命名习惯。 没有标准答案,只有主观的好或者相对不好的判断。 但真的很重要: 良好的命名习惯可以提高编程效率;减少出错; 良好命名的程序清晰易读。 好的名称可以提供很多有价值的信息。 |
规则1 全程使用英文,不准用拼音
▪KHBH XH ZHYE DQJG – 猜得出这些名称是什么意思吗? |
sCustomerNo, sStudentNo fAccountBalance fCurrentPrice |
Too long for you ? |
sCusNo, sStuNo, fAccBalance , fCurPrice |
规则2 变量/类的数据成员的命名
类型名缩写(小写) + 英文单词或其缩写(首字母大写)
类型 |
解释 |
缩写 |
举例 |
float |
浮点数 |
f |
fPrice fSum fAmount fScore fHeight fWeight |
int |
整数 |
i |
iCount / iCnt iStudentCount iWidth iHeight iCapacity |
string |
字符串 |
s |
sStudentNo sMemo sHint sDiagnostics sContent sName |
bool |
布尔型 |
b |
bFound bCaptured bFull bHungry bDied bMarried bAvailable |
如果变量表达的是一个集合(数组或者list), 用小写的英文单词的复数形式:
students members prices wheels teachers universities shoes arms
规则3 函数的命名
一个英文单词:小写 add( ) convert( ) del( ) empty( ) try( ) pop( ) push( ) 两个英文单词:第二个单词首字母大写 动+名 addAmount( ) setPrice( ) getPrice( ) setEmpty( ) pushDown( ) riseUp( ) toString( ) toDouble( ) |
规则4 类型的命名
由一个或者两个英文单词构成,每个单词的首字母均大写 FloatBuffer PrinterQueue Student Lesson Movie Song Employee Team Board Company Supplier GoldFish CellPhone GraphDrawer 在面向对象程序设计当中,一个文件通常只包括一个类型,通常文件名由类型名 + . + 扩展名构成: Student.py Company.h Company.cpp PrinterQueue.java |
规则5 例外
如果有一个临时变量,仅在上下几行局部代码中被使用,用完即弃,可以用小写单字母:(代码阅读者容易通过上下文确定变量的类型和用途)
s = s + “, Done” print(s) for i in range(100): print(i)
当心中文目录及中文文件名
很多开发环境及软件对中文的支持并不好,永远不要使用任何包含中文的目录或文件名:
示例 |
正/误 |
d:/学习资料/python/实验1 |
X |
d:/Learing/python/Test1 |
√ |
忠告
命名这件事不同的人有不同的看法。 认真命好每个名, 尽量遵守规则。 表面上花时间,实际上省时间。 程序如果需要交给教师检查或者请求教师协助,两件事情先做好:
|
本案例节选自作者编写的教材及配套实验指导书。
《C++编程基础及应用》(高等教育出版社,出版过程中)
《Python编程基础及应用》,高等教育出版社
《Python编程基础及应用实验教程》,高等教育出版社
高校教师同行如果期望索取样书,教学支持资料,加群,请私信作者,联系时请提供学校及个人姓名为盼,各高校在读学生勿扰为谢。
青少年读者们如果期望系统性地学习Python及C/C++程序设计语言,欢迎尝试下述今日头条(西瓜)免费视频课程。
C/C++从入门到放弃(重庆大学现场版)
Python编程基础及应用(重庆大学现场版)
免责声明:本站所有文章内容,图片,视频等均是来源于用户投稿和互联网及文摘转载整编而成,不代表本站观点,不承担相关法律责任。其著作权各归其原作者或其出版社所有。如发现本站有涉嫌抄袭侵权/违法违规的内容,侵犯到您的权益,请在线联系站长,一经查实,本站将立刻删除。 本文来自网络,若有侵权,请联系删除,如若转载,请注明出处:https://yundeesoft.com/95520.html