这一篇文章想要介绍的是编写代码的时候业界比较常用的一些命名规范,以及个人平时的一些命名规范。涉及“驼峰命名法”、“下划线命名法”、“帕斯卡命名法”、“匈牙利命名法”的介绍和见解。属于C语言基础篇(持续更新


刚刚开始学习编程的时候,我的第一个老师便强调过,命名要规范,需要做到见名知意,当时不以为然。不就给变量起个名字吗?26个字母什么时候用完过,再不够加个1234567不就行了吗?a1,a2,a3什么时候用的完?但是嘛,平时做做练习随便命名倒还行,毕竟代码量不多。当你的代码量多起来了,开始模块化编程开始写项目的时候,规范的命名就显得很重要了。

规范的命名可以让你在代码调试的过程中快速的知道当前变量的功能和定义时的目的。而不需要在这个文件看到一个变量,又要赶紧翻到别的文件去看看这个变量定义来是干嘛的。

对于规范命名,有很多编程入门书籍都有讲到。为此阿里还专程编辑整理出了一本书《阿里巴巴Java开发手册》来规范业界的代码习惯。可见代码规范化有多重要了。

好了,说了那么多有的没的,其实意义也不大。因为会看到这个标题而点进来看的人,本身就是那些已经意识到写代码命名需要规范的人了。我们进入正题吧!

这篇文章,仅仅是想要分享一下我自己平时做项目的一些命名习惯,这里面的内容并非什么资深的专业规范,更没有什么权威性。仅仅只是个人借鉴网上的一些命名方法,以及平时使用库函数时对于前人一些命名规范的效仿,再结合自身的编程习惯,给自己制定的一套命名规则。


在分享我自己的命名规范之前,我们先来简单了解一下几个比较出名的命名方法。

常用的命名方法


驼峰命名法:

char myName[10] = {“ShiYi”};

驼峰命名法的特点是:变量名由多个单词组成,其第一个单词的首字母小写,后面每一个单词的首字母都要大写,由于其外形看起来像驼峰一样上下起伏故得名。这也是大家平时编程开发的时候用的比较多的一个命名方法。因为这种命名方法使用起来非常顺手,而且外形也很好看。


帕斯卡命名法:

char MyName[10] = {“ShiYi”};

名字听起来很高大上,实际上就是把驼峰命名法的第一个单词的首字母也改为大写。所以也称之为大驼峰命名法。但由于人们在输入习惯上面,通常在输入第一个单词的时候,不会刻意切换大小写,所以没有驼峰命名法使用起来顺手。


下划线命名法:

char my_name[10] = {“ShiYi”};

名如其意,每个单词之间用下划线隔开。但是由于有下划线的加入会让变量整体看起来过长,不过这种命名方法却有通俗易懂的效果,由于每两个单词之间用一小块空白隔开,所以即便是一个完全没有命名规范认知的新手,也能一眼就看出这个变量想要表达的东西。


匈牙利命名法:

char cMyName[10] = {“ShiYi”};

这个命名法就有点意思了,好像是一个匈牙利的程序员在很久以前发明的。其特点是用名字的前一到两个字母来表示变量的类型,后面表示变量意思的单词首字母大写。

这个命名方法也是业界被批判最多的一个命名方法了,具体原因说起来有点长,主要还是由于数据类型的不断增加以及如今IDE功能的不断完善导致的,前者导致了这种命名方法的缺点不断放大,后者导致这种命名方法的优点不断缩小。而且由于C++中模版关键字“template”的引入,使得变量类型的不确定性大大增加,更加放大了这种命名方法的缺点。对于这个命名方法,我不做太多评价,我觉得嘛,出发点是挺好的,只是实在有一些致命的缺点还没法解决。


好了,目前业界比较常见的几个命名规范都已经有所了解了。

下面就是我自己命名规范了,这是我很久以前刚刚开始学习编程的时候,弄完第一个项目之后,制定给自己的,后面的学习过程中也不断的完善更新着。对于C语言的开发,这套规范完全够用了。但是后面接触到了C++和Qt之后,类型和特性什么的多了之后,渐渐的也开始有点力不从心了。

不过这个问题也不是一时半会能真正解决的,对于命名规范的书籍有很多,但是业界到目前为止也没有一套真正公认合适好用的大家普遍遵循的命名规范。这也一直是一个问题,几乎都处于家有家规国有国法的现状,不同的公司不同的团队不同企业有其自己制定的命名规范,只要开发团队之间协调好即可。

所以我这套命名规范目前来说只适用于个人,适用范围也比较窄,仅仅涉及常用的类型,对于一些不太常用的类型很少涉及,其实我也不太愿意涉及太多的内容,一个体系如果过于庞大便会变得过于笨重,难以变通不够灵活。我宁愿它简洁一点,高效一点,也实用一点。虽然以后有什么更好的想法可能还是会更新的,不过现在就只到这里了。。。


以下是我的命名规范:


总体规范:

  • 所有命名中第一个字母都用以说明属性
  • 带下画线的都是类型
  • 不带下画线的都是对象(这里的对象也包含变量(下同))
  • 第一个字母大写表示特殊类型的对象
  • 第一个字母小写表示普通类型的对象

常见类型命名规范

  • 函数命名规范:帕斯卡加下画线

    int my_Function(void);

标志是有下画线的同时用驼峰命名

  • 类、结构体、联合体命名规范:以大写字母C或S或L开头接上帕斯卡加下画线

  类:

    class CMy_Class{}

  结构体:

    struct SMy_Struct{};

  链表:

    struct LMy_List{};

    首字母大写C表示类,S表示结构体,L表示链表

标志是两个大写开始


特殊类型命名规范

  • 宏定义和常量和枚举命名规范:全部大写

    #define MYMACRO 0

标志是全部大写

  • typedef重命名对象:还没想好
  • 引用类型:还没想好

常见对象命名规范

  • 普通类型对象命名规范:匈牙利加驼峰(小写类型加驼峰)

    int imyName = 0;

    小写的首字母表示类型,后面接驼峰

标志是两个小写开始


特殊类型对象命名规范:

  • 结构体对象的命名规范:小写s加帕斯卡

    SMy_Struct sMyStruct = NULL;

  • 类的对象命名规范:小写c加帕斯卡

    cMyClass = new CMy_Class;

  • 链表对象的命名规范:小写l加帕斯卡

    LMy_List lMyList = NULL;

标志是一个小写字母开头接大写


总结一下:我用这个规范定义名字,先看有没有下划线,如果有则说明这是个类型或者函数,然后看首字母,小写是函数,大写就是别的,再通过类型来判断。如果名字里面没有下划线,则说明这是个对象,然后看首字母,如果是小写,普通数据类型,如果是大写这是别的,再通过类型来判断。


原博客始发于CSDN,在如今博客界的转载抄袭泛滥的环境下,原创不易,点个赞再走呗。以下是博客首页的链接。


零BUG是原则性问题。

C/C++命名规范-C语言基础的更多相关文章

  1. Java语言基本语法(一)————关键字&标识符(Java语言标识符命名规范&Java语言的包名、类名、接口名、变量名、函数名、常量名命名规则 )

    一.关键字 关键字的定义和特点 定义:被Java语言赋予特殊含义,用做专门用途的字符串(单词). 特点:关键字中所有字母均为小写 下面列举一些常用的关键字. 用于定义数据类型的关键字:byte.sho ...

  2. Go语言基础语法总结

    1. 认识HelloWorld 在前面的<Go的安装和使用>这篇文章中已经写过HelloWorld.go了,现在就来逐行认识一下它. package main import "f ...

  3. c语言基础数据类型及命名规范

    1. 常量是程序运行期间不能被改变的量; 变量代表一个存储区域,存储区域内存储的内容就是变量的值, 变量的值可以在程序运行期间改变  (变量就像一个杯子, 用来存放水, 杯子里的水即变量的值是可以改变 ...

  4. 初识 Javascript.01 -- Javascript基础|输出方式、变量、变量命名规范、数据类型、

    Javascript基础 1 聊聊Javascript 1.1 Javascript的历史来源 94年网景公司   研发出世界上第一款浏览器. 95年 sun公司   java语言诞生 网景公司和su ...

  5. JavaScript 引入方式 语言规范 语言基础 数据类型 常用方法 数组 if_else 比较运算符 for while 函数 函数的全局变量和局部变量 {Javascript学习}

    Javascript学习 JavaScript概述 ECMAScript和JavaScript的关系 1996年11月,JavaScript的创造者--Netscape公司,决定将JavaScript ...

  6. OC基础之方法和参数的命名规范

    以前学过C/C++/Java/C#语言的童鞋可能刚开始对于OC的方法和参数的命名规范大为不爽 举例来说,如下一个OC方法: - (void)tableView:(UITableView *)table ...

  7. java基础之Java变量命名规范

    本文介绍的是java中的变量的命名规则,对于初学者来说,还是很重要的.希望对你有帮助,一起来看. Java是一种区分字母的大小写(case-sensitive)的语言,下面谈谈Java语言中包.类.变 ...

  8. C语言常见命名规范

    C语言常见命名规范   1 常见命名规则 比较著名的命名规则首推匈牙利命名法,这种命名方法是由Microsoft程序员查尔斯·西蒙尼(Charles Simonyi) 提出的.其主要思想是“在变量和函 ...

  9. c#基础学习(0625)之vs常用快捷键、基础数据类型、命名规范

    vs常用快捷键 Ctrl+K+D:快速对齐代码 Ctrl+z:撤销 Ctrl+S:保存 Ctrl+J:快速弹出只能提示 Shift+End:从行首快速选中整行 Shift+Home:从行未快速选中整行 ...

  10. Android 开发 命名规范(基础回顾)

    标识符命名法标识符命名法最要有四种: 1 驼峰(Camel)命名法:又称小驼峰命名法,除首单词外,其余所有单词的第一个字母大写. 2 帕斯卡(pascal)命名法:又称大驼峰命名法,所有单词的第一个字 ...

随机推荐

  1. DoTween结束后删除对象

    using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; ...

  2. protobuf如何还原proto源文件及描述字符串中左括弧的意义

    语法分析 和通常的有语法的结构一样,proto的编译也经过词法(tokenize)和语法(parse)两个阶段,相关代码分别在tokenizer.cc和parser.cc两个文件中. /// @fil ...

  3. WebService 客户端上传图片,服务器端接收图片并保存到本地

    需求:如题,C#本地要调用Webservice接口,上传本地的照片到服务器中: 参考:客户端: https://blog.csdn.net/tiegenZ/article/details/799276 ...

  4. nginx代理出现上传文件过大解决办法

    1.错误描述 2.错误原因 1.上传文件时,利用localhost访问系统,不会出现这个问题:用域名访问这个系统时,出现这个问题,提示是:请求实体太大 由于Nginx反向代理服务器client_max ...

  5. iOS 扩展与分类的区别

    1.分类 category 分类的作用就是在不修改原有类的基础上,为一个类扩展方法,最主要的是可以给系统类扩展我们自己定义的方法 分类也能使用@property 添加属性 [通过runtime 关联对 ...

  6. WPF中向下拉框中绑定枚举体

    1.枚举绑定combox的ItemsSourceItemsSource绑定的是个集合值,要想枚举绑定ItemsSource,首先应该想到的是把枚举值变成集合. 方法一:使用资源里的ObjectData ...

  7. linux 设置开机自动挂载文件系统

    一./etc/ 下增加rc.local文件(ubuntu默认没有这个文件) kuaibang@face:~$ sudo touch rc.local 二.安装NFS客户端 a.如果您使用CentOS. ...

  8. 前端-对js原型继承的简单举例

    function A(name,color){ this.name=name; this.color=color;   } A.prototype.getColor=function(){ retur ...

  9. 题目集4~6的总结性Blog

    题目集4~6的总结性Blog (1)前言 在这三次作业中,主要考察了正则表达式以及类间的关系.在这三次作业中,相比之下,第四次以及第五次作业的难度明显高于第六次作业,题量与难度相较于以往的作业也有明显 ...

  10. go 单测

    1.在需要测试的go文件同级目录下创建${需要测试的文件名}_test.go文件 2. err, info :函数的返回值 "account-base-dd",1:传进去的参数 f ...