国产一级a片免费看高清,亚洲熟女中文字幕在线视频,黄三级高清在线播放,免费黄色视频在线看

打開(kāi)APP
userphoto
未登錄

開(kāi)通VIP,暢享免費(fèi)電子書(shū)等14項(xiàng)超值服

開(kāi)通VIP
研發(fā)之路:C代碼注釋引發(fā)的“血案”

沒(méi)有血案,但有些沖突。不是代碼bug,我要講注釋風(fēng)格。


這位看官,既然來(lái)了,且讀且評(píng)吧。故事是真實(shí)的,如有雷同純屬巧合。


  事情是這樣的,有人離職,公司調(diào)我補(bǔ)缺。那個(gè)系統(tǒng)一直有個(gè)工程師在維護(hù),參與該系統(tǒng)的新人來(lái)了又走,他始終泰若磐石。剛過(guò)去一個(gè)禮拜,我就心下竊吼:“坑爹啊!”,也徹底體會(huì)到什么叫---絕對(duì)的權(quán)威、專家。該軟件系統(tǒng),是公司發(fā)家的支柱產(chǎn)品,涉及十幾個(gè)國(guó)家x七八個(gè)機(jī)型,700+個(gè)文件(C語(yǔ)言,所有.c .h檔),十幾萬(wàn)行代碼,盡兩百個(gè)跨模塊全局變量,編譯條件成百上千......(好吧,這是找借口、吐槽的節(jié)奏)


  盡管有名義上的交接,和幾次和聲細(xì)語(yǔ)的密切指導(dǎo)。但真正獨(dú)立展開(kāi)工作時(shí),許多小功能增刪改,我都要折騰個(gè)好幾天才能厘清代碼調(diào)用關(guān)系、算法原理,然后找到修改點(diǎn)謹(jǐn)慎細(xì)微龜速前行。進(jìn)度追蹤的人有的時(shí)候也催毛了,直接請(qǐng)專家大師出手,咔咔咔,不到半天就搞定了。當(dāng)然,前期我當(dāng)然盡量的”不恥上問(wèn)”,但人嗎,總是有遇到被激發(fā)“骨氣”的時(shí)候。


  這幾天,好不容易搞好一個(gè)全新的功能模塊,把代碼推送給他合并編譯。不曾想,出現(xiàn)了讓我泣血的一幕。


  我眼睜睜地、眼睜睜看著她把我辛苦敲入的代碼注釋/**/通通換成//,一份精美的代碼,頓時(shí)成渣。

  我詢問(wèn)緣由,她的回答是: 當(dāng)代碼里面充滿注釋符號(hào)/**/時(shí),她想要用/**/注釋整段代碼時(shí),就會(huì)很麻煩。 我理解了,因?yàn)?**/不支持嵌套。比如下面這樣的語(yǔ)句是編譯不過(guò)的。

  /*

  a = b+c; /* 注釋 */

  */

  我的手抬了抬,終究作罷。雖然我感覺(jué)到尊嚴(yán)被踐踏,心愛(ài)的作品被蹂躪,但我還是開(kāi)始反思。

  許多軟件規(guī)范、專家、有經(jīng)驗(yàn)的工程,都建議或要求注釋代碼最好使用 /**/,他們的理由大略如下:

  1. “//” 的注釋的嚴(yán)密性不夠。 例如

  // 注釋語(yǔ)句 ??/

  a = b+c;

  此時(shí),a = b+c在一些編譯器不會(huì)被執(zhí)行。

  因?yàn)???/'會(huì)被編譯器當(dāng)作 \,變成C語(yǔ)言的換行符。于是這段代碼等同于

  // 注釋語(yǔ)句 a = b+c ;

  就會(huì)被注釋掉。大家有興趣的,不妨去搜索一下'C語(yǔ)言 三字母詞'

  當(dāng)然,哪怕沒(méi)有??/, 自己打盹碰到delete鍵也是會(huì)屏蔽掉a=b+c的

  2. “//” 的注釋,是C++發(fā)展后才引進(jìn)的。 有些早期的C編譯器對(duì)這種注釋是不支持的。代碼要做到全平臺(tái)兼容,這點(diǎn)是必需要考慮的。

  因此,老外定義的C語(yǔ)言軟件規(guī)范,無(wú)論是MISRA還是CMMI,一般都要求所有代碼注釋必須使用/**/。


  君不見(jiàn),那uCOS的最新版本源碼,所有注釋都是/**/。

  君不見(jiàn),那STM32的最新固件庫(kù),洋洋灑灑幾十個(gè)文件,通篇皆沒(méi)有用到//。


  正是基于這樣的理由,讓我的心中充滿了慍怒。但我仍然沒(méi)有當(dāng)場(chǎng)反駁她,因?yàn)檫@些理由還有些蒼白無(wú)力。


  1. 當(dāng)時(shí),那個(gè)什么三字母詞“??x”到底是什么我已經(jīng)忘了,沒(méi)法立刻做試驗(yàn)編譯給她看。

  而且時(shí)候我里面作了編譯實(shí)驗(yàn),得到的是

  'filename.c', line xxxx: Warning: #2532-D: support for trigraphs is disabled xx代碼語(yǔ)句xx // ??/

  trigraph金山詞霸---> [traigra:f]三字母詞

  看吧,編譯器都警告了,默認(rèn)是不支持的。

  2. 而且,所謂的//是C++的,早期的c編譯器不支持。

  這點(diǎn)誰(shuí)鳥(niǎo)啊,我們只要現(xiàn)在,只用最新版本的編譯器。

  所以,我還要繼續(xù)思考。

  我要維護(hù)這個(gè)傳統(tǒng),為自己代言......


我開(kāi)始思考,還有什么強(qiáng)勁有力的理由,來(lái)支持我恪守的真理:c語(yǔ)言代碼注釋必須使用/**/.


  有的!

  倘若所有代碼里面的注釋用到/**/時(shí),當(dāng)你要注釋掉這段代碼時(shí),如果不想忍受編譯器的嵌套報(bào)警,又懶得把一個(gè)個(gè)/**/換成//的話。那么你還有如下選擇。


  1) 慎重思考下是否刪光這段代碼,如果還有些不舍,那就先'備份'(git推送)一下再刪光。因此,

  理由一:使用/**/注釋代碼,會(huì)使軟件系統(tǒng)減少冗余的僵尸代碼,鼓勵(lì)程序員的程序備份行為。

  2) 或者用編譯條件圈起來(lái),如下。

  #if (XXX_ENABLE)

  func(a, b, c); /* 注釋 */

  ...... /* 注釋 */

  #endif

  那么你不得不考慮xxx的命名,如何更加一目了然,再寫(xiě)點(diǎn)注釋什么的,表明對(duì)這段代碼“棄而不舍”的緣由。因此,


  理由二:使用/**/注釋代碼,會(huì)鼓勵(lì)程序員刪除代碼時(shí),三思而后行,并且注明舍棄的理由。

  3) 當(dāng)然,偷懶的人還是會(huì)用 #if 0 #endif圈起來(lái), 如下,

  #if 0

  func(a, b, c); /* 注釋 */

  ...... /* 注釋 */

  #endif

  而且不會(huì)寫(xiě)任何注釋表明刪除的理由。然而,“#if 0”是一個(gè)如此的醒目,很容易成為一個(gè)評(píng)估軟件質(zhì)量、工作績(jī)效的搜索關(guān)鍵詞。從管理的角度,這個(gè)是可以量化的。因此,


  理由三: 使用/**/注釋代碼,有利于公司進(jìn)行軟件質(zhì)量控管,對(duì)程序員績(jī)效考核。

  這三個(gè)理由,足夠?yàn)樽约捍詥?


延伸閱讀:

C語(yǔ)言實(shí)現(xiàn)FFT(快速傅里葉變換)
C語(yǔ)言的那些小秘密之動(dòng)態(tài)數(shù)組
C語(yǔ)言的那些小秘密之異常處理
硬件工程師的10個(gè)C語(yǔ)言技巧
C語(yǔ)言難點(diǎn)及分析
如何寫(xiě)出高效優(yōu)美的單片機(jī)C語(yǔ)言代碼?


回復(fù):運(yùn)算放大器、傅里葉、阻抗、小波、type c、信號(hào)、單片機(jī)、示波器、模擬、畢設(shè)、電阻、DSP、電路、面試、電源、FPGA、USB、CAN(回復(fù)你想看的)


喜歡請(qǐng)收藏
分享本文
&

EDN電子技術(shù)設(shè)計(jì)

微信號(hào): edn-china

電子工程師的靈感設(shè)計(jì)之源

▼點(diǎn)擊原文看更多文章

本站僅提供存儲(chǔ)服務(wù),所有內(nèi)容均由用戶發(fā)布,如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容,請(qǐng)點(diǎn)擊舉報(bào)
打開(kāi)APP,閱讀全文并永久保存 查看更多類似文章
猜你喜歡
類似文章
我為什么放棄Go語(yǔ)言
C語(yǔ)言 #pragma once - C語(yǔ)言零基礎(chǔ)入門(mén)教程
Common Lisp語(yǔ)言快速入門(mén)
C語(yǔ)言程序結(jié)構(gòu)「菜鳥(niǎo)入門(mén)篇」
UC頭條:C 基礎(chǔ)篇之基本語(yǔ)法解析
大講臺(tái)說(shuō)程序員深愛(ài)的那些不良編程習(xí)慣
更多類似文章 >>
生活服務(wù)
分享 收藏 導(dǎo)長(zhǎng)圖 關(guān)注 下載文章
綁定賬號(hào)成功
后續(xù)可登錄賬號(hào)暢享VIP特權(quán)!
如果VIP功能使用有故障,
可點(diǎn)擊這里聯(lián)系客服!

聯(lián)系客服