美文网首页C语言学习C语言
编程注释大家都会写吧,这种“挨踢”的注释玩过没?

编程注释大家都会写吧,这种“挨踢”的注释玩过没?

作者: C语言基础 | 来源:发表于2018-07-23 20:56 被阅读4次

注释大家都会写,主要用来帮助程序员理解代码的意思,下面列举了几个真实的注释,如果是当您接手这样的项目看到这样的注释时,会做如何反应呢?笔者这里表示已经哭笑不得了…

1.看下面的这段C++注释,PS:新人表示看不懂

C/C++学习乐园:747821062

2.这家公司一定得罪这位web工程师了。。

C/C++学习乐园:747821062

3.改bug还是重写?

C/C++学习乐园:747821062

更多精彩,欢迎私信我

4、要是调试半天才看到这个语句,新人表示已泪奔

C/C++学习乐园:747821062

编程规范文档推荐

C/C++学习乐园:747821062

写代码和注释的第一目的是帮助人理解代码,理解作者的意图。所以优秀的代码本身就有自说明功能,只有在代码本身无法清晰地阐述作者的意图时,才考虑写注释,也即是:注释应该表达“我的代码为什么要这么做?”,而不是表达“我的代码做了什么?”

C/C++学习乐园:747821062

写注释应遵循奥卡姆剃刀原则:如无必要,勿增实体。注释写的不好、维护得不好(比如改了代码没改注释)会导致代码的可读性变差。

C/C++学习乐园:747821062

朋友们还遇到什么让您搞笑的注释呢? 欢迎联系我们,分享您的“挨踢”趣事~

相关文章

  • 编程注释大家都会写吧,这种“挨踢”的注释玩过没?

    注释大家都会写,主要用来帮助程序员理解代码的意思,下面列举了几个真实的注释,如果是当您接手这样的项目看到这样的注释...

  • Java基础(1)

    注释 单行注释 //注释内容 多行注释/*注释内容 */ 文档注释/**注释内容 */ 注释在编程中是一个好习惯...

  • Java基础

    注释 单行注释 //注释内容 多行注释/*注释内容 */ 文档注释/**注释内容 */ 注释在编程中是一个好习惯...

  • 2019-05-31

    注释规范非常影响自身和别人的编程体验,不管别人怎样吧,自己写的遵守以下规范: 1、文件注释a.注释开始 /* 不可...

  • Java基础——注解

    基本概念 在JAVA中我们都知道有注释的概念,注释有单行注释多行注释文档注释。这种注释是给开发人员看的。而在JAV...

  • Flutter自动注释(尾注释)、 Android Studio

    相信大家都找Flutter自动注释、Flutter尾注释、 Android Studio自动注释、Flutter尾...

  • tableView点击下拉菜单

    先给大家看看效果图吧 直接给大家看代码吧,注释都很详细 我在button的点击方法里注释了一段代码,解除注释后运行...

  • 利用类C注释方法来实现两段临近代码的快速切换

    说明:类C注释方法 即指类似C语言的注释方法,包含//行注释以及/* */快注释。所有支持这两种注释方法的编程语言...

  • 2018-09-20 Java基础语法

    2018-09-20 Java基础语法 [TOC] 注释 单行注释 多行注释 文档注释 这种方法注释的内容会被解释...

  • 【Android开发学Flutter】代码注释

    大家都知道代码注释的重要性,Dart 的注释规范传送门: Effective Dart: 文档 Dart注释的类型...

网友评论

    本文标题:编程注释大家都会写吧,这种“挨踢”的注释玩过没?

    本文链接:https://www.haomeiwen.com/subject/kicsmftx.html