【正文】
可重入函數(shù) 可重入函數(shù)中若使用了全局變量,應(yīng)通過(guò)關(guān)中斷、信號(hào)量等操作手段對(duì)其加以保護(hù)。 Switch ( ) { case x: break。共同占用一行。 l 函數(shù)形參之間應(yīng)該有且只有一個(gè)空格(形參逗號(hào)后面加空格)。避免把注釋插入分行中。 l 各程序段之間使用一個(gè)空行分隔,加以必要的注釋。 l 多個(gè)形參的函數(shù),后一個(gè)形參與前一個(gè)形參的逗號(hào)分割符之間添加一個(gè)空格。 l 函數(shù)的返回值要清楚明了,尤其是出錯(cuò)返回值的意義要準(zhǔn)確無(wú)誤。 l 全局效率:軟件系統(tǒng)的整體效率高。對(duì)單個(gè)標(biāo)識(shí)符的注釋加在定義語(yǔ)句的行尾。其中函數(shù)名稱(chēng)應(yīng)簡(jiǎn)寫(xiě)為FunctionName(),不加入、出口參數(shù)等信息。 文件注釋 文件注釋必須說(shuō)明文件名、函數(shù)功能、創(chuàng)建人、創(chuàng)建日期、版本信息等相關(guān)信息。局部循環(huán)體控制變量?jī)?yōu)先使用i、j、k等;局部長(zhǎng)度變量?jī)?yōu)先使用len、num等;臨時(shí)中間變量?jī)?yōu)先使用temp、tmp等。 l 命名中若使用特殊約定或縮寫(xiě),要有注釋說(shuō)明。 // 有符號(hào)16位整型變量 // typedef unsigned long INT32U。 2 單片機(jī)C51編程規(guī)范-范圍 本標(biāo)準(zhǔn)規(guī)定了程序設(shè)計(jì)人員進(jìn)行程序設(shè)計(jì)時(shí)必須遵循的規(guī)范。 // 無(wú)符號(hào)8位整型變量 // typedef signed char INT8S。通常,較短的單詞可通過(guò)去掉元音字母形成縮寫(xiě);較長(zhǎng)的單詞可取單詞的頭幾個(gè)字母形成縮寫(xiě)。 變量命名 變量名用小寫(xiě)字母命名,每個(gè)詞的第一個(gè)字母大寫(xiě)。 l 一般情況源程序有效注釋量在30%左右。 /*********************************************************** 文件名稱(chēng): 作 者: 版 本: 說(shuō) 明: 修改記錄: ***********************************************************/ 函數(shù)注釋 函數(shù)頭部注釋 函數(shù)頭部注釋?xiě)?yīng)包括函數(shù)名稱(chēng)、函數(shù)功能、入口參數(shù)、出口參數(shù)等內(nèi)容。 通常,分支語(yǔ)句(條件分支、循環(huán)語(yǔ)句等)必須編寫(xiě)注釋。 l 可測(cè)試性:程序便于測(cè)試和評(píng)價(jià)。 l 函數(shù)內(nèi)部局部變量定義區(qū)和功能實(shí)現(xiàn)區(qū)(包含變量初始化)之間空一行。 l 函數(shù)名稱(chēng)與出口參數(shù)類(lèi)型定義間應(yīng)該空一格且只空一格。