技術(shù)規(guī)范知識(shí)84-展示頁(yè)
2025-04-24 23:11本頁(yè)面
【正文】 解模塊的概要非常有效，而且在維護(hù)時(shí)也同樣有效，所以一定要記述?！北硎究蛇x項(xiàng)目。 SPECIAL INFO說(shuō)明：“173。 USAGE175。 CREATE175。 ENVIRONMENT175。 ABSTRACT/PURPOSE175。 AUTHOR173。 VERSION175。 SYSTEM173。 注意事項(xiàng)175。 更改記錄(d)其它175。 編譯、連接信息make file名，命令過(guò)程文件名，編譯、連接選項(xiàng)（Option），應(yīng)連接的裝配模塊文件名，子程序庫(kù)名等(c) 文件維護(hù)信息版本，日期，作者所屬部門(mén)名，作者姓名，補(bǔ)充說(shuō)明等173。 功能說(shuō)明（主要模塊說(shuō)明）175。 著作權(quán)聲明(b)文件說(shuō)明信息173。 所屬（從屬模塊時(shí)）173。 程序名或模塊名173。(1) 文件注釋（文件頭）,文件注釋記述以下信息 (a)文件識(shí)別信息175。（頭注釋）頭注釋可以大致分為文件注釋、模塊注釋、數(shù)據(jù)注釋等。(8)錯(cuò)誤處理。所有輸入數(shù)據(jù)都應(yīng)經(jīng)過(guò)檢查。功能性注釋嵌在源程序內(nèi)部用來(lái)描述處理功能。d． 履歷描述。c． 數(shù)據(jù)描述。b． 接口描述。包括以下幾部分內(nèi)容：a． 功能描述。注釋分為序言性注釋和功能性注釋兩種。(5)適當(dāng)?shù)淖⑨?。命名?yīng)有實(shí)際意義，一般格式為：前綴+由形容詞、名詞或動(dòng)詞組成的詞組。d． 在注釋段與程序段以及不同程序段之間插入空行。b． 每行只寫(xiě)一條語(yǔ)句。(3)利用標(biāo)準(zhǔn)書(shū)寫(xiě)格式提高程序的可讀性。(2)用括號(hào)體現(xiàn)優(yōu)先級(jí)和嵌套的層次。(1)合理使用goto語(yǔ)句。編碼的目標(biāo)首先是清晰正確，其次才是程序的效率。不可未經(jīng)充分的重查而隨便進(jìn)入下一步測(cè)試階段。否則就會(huì)為以后修改、改造造成困難。(4)關(guān)于數(shù)據(jù)庫(kù)的記錄規(guī)范等的包含文件、模塊頭、宏等，要采用系統(tǒng)統(tǒng)一的規(guī)定。(3)在編碼的過(guò)程中發(fā)現(xiàn)了設(shè)計(jì)上的問(wèn)題時(shí)，要向上追溯到系統(tǒng)設(shè)計(jì)書(shū)／程序設(shè)計(jì)書(shū)。在頭腦中要經(jīng)?？紤]程序的讀者，按照向讀者說(shuō)明的方式來(lái)寫(xiě)是一個(gè)竅門(mén)。對(duì)于不明確之處不可隨意判斷，應(yīng)確認(rèn)后再進(jìn)行。(1)認(rèn)真分析理解系統(tǒng)設(shè)計(jì)書(shū)、程序設(shè)計(jì)書(shū)（有時(shí)也包括流程圖）。本規(guī)范作為編碼的通常標(biāo)準(zhǔn)，希望每個(gè)人都可以通過(guò)按此規(guī)范進(jìn)行編碼，提高程序的可讀性、可修改性及維護(hù)的效率。良好的編碼習(xí)慣可以幫助程序員避開(kāi)不必要的語(yǔ)法或語(yǔ)義錯(cuò)誤，對(duì)出現(xiàn)的錯(cuò)誤迅速定位。在編碼時(shí)，為減少在編碼水平上的個(gè)人差異、順利地進(jìn)入單體試驗(yàn)階段,以及便于進(jìn)行調(diào)試和提高維護(hù)效率，特制定本標(biāo)準(zhǔn)。17 / 20編碼標(biāo)準(zhǔn) 批準(zhǔn)人劉巖審核人崔戈擬制人劉慧豐批準(zhǔn)日期1999．5．12生效日期1999．5．12關(guān)聯(lián)文件沈陽(yáng)東東系統(tǒng)集成有限公司更改記錄序號(hào)發(fā)行日更改對(duì)象更改內(nèi)容批準(zhǔn)審查擬制01999．5．12新發(fā)行劉巖崔戈劉慧豐目 錄1. 目的 2/42. 編碼的注意事項(xiàng) 2/43. 編碼風(fēng)格 2/44. 序言性注釋格式 3/4附錄頭注釋樣例 1/4(附) 編碼是以程序設(shè)計(jì)時(shí)做成的程序規(guī)范書(shū)、流程等邏輯設(shè)計(jì)書(shū)為基礎(chǔ)。本標(biāo)準(zhǔn)作為代碼的書(shū)寫(xiě)標(biāo)準(zhǔn)，其主要目的在于統(tǒng)一程序設(shè)計(jì)的記述風(fēng)格，培養(yǎng)良好的編碼習(xí)慣，使代碼記述清晰、明確，具有良好的可讀性。另外，良好的編碼習(xí)慣還有助于在編碼
公司管理相關(guān)推薦
鄂ICP備17016276號(hào)-1