【正文】 ... ... ? 帶注釋的 指令不得少于整個(gè)程序指令數(shù)的三分之一 . ? 在同一個(gè)文件中 , 盡量將注釋對(duì)齊 . ? 每實(shí)現(xiàn)一相對(duì)完整邏輯功能的一段指令前必須用注釋給出該功能的描述 , 且各個(gè)該類型指令段間用空行或注釋行分隔 . 認(rèn)證系列： 高級(jí)職業(yè)經(jīng)理 CEO 資格認(rèn)證、人力資源總監(jiān)、營(yíng)銷經(jīng)理、財(cái)務(wù)總監(jiān)、企業(yè)培訓(xùn)師、酒店經(jīng)理、品質(zhì)經(jīng)理、生產(chǎn)經(jīng)理、營(yíng)銷策劃師 等學(xué)習(xí)認(rèn)證系列 。... ? 每一個(gè)變量都應(yīng)以注釋 , 對(duì)其用途、含義、可能的取值加以說(shuō)明。... 。..._ ... ? 如果注釋太長(zhǎng) , 超出一行 ,應(yīng)將其按如下格式放在語(yǔ)句之前 : 。xxxxx ? 在語(yǔ)句后的注釋必須與語(yǔ)句在同一行 : statement 。 常量 對(duì)公共使用的常量 , 在 . 標(biāo)號(hào) ? 所有標(biāo)號(hào)應(yīng)在第一列開(kāi)始 . ? 標(biāo)號(hào)名稱由子過(guò)程名稱的簡(jiǎn)寫(xiě) (用大寫(xiě)字母 )加下劃線加有具體含義的單詞構(gòu)成。對(duì)于外部 (公共 )子過(guò)程名 ,在第一個(gè)字符之前加 _. 變量名 變量名的長(zhǎng)度沒(méi)有限制 . 但各個(gè)變量的前 31個(gè)字符必須唯一 .(各系 統(tǒng)的狀態(tài)會(huì)有變化 , 盡可能在開(kāi)始時(shí)加以區(qū)分 ).建議用英文語(yǔ)句的一般風(fēng)格命名變量名 . 英文單詞的首字母大寫(xiě)，后面的字母小寫(xiě)。 % 圖 D3 標(biāo)準(zhǔn)格式 (in “ ” ) 修改舊代碼 在過(guò)程頭上的所有必要的信息必須修改 , 版本狀態(tài)必須包含版本日期 , 程序員姓名 , 以及版本的簡(jiǎn)要描述 , 這種描述必須規(guī)格化 , 而且要包含足夠的信息 , 以便于對(duì)這些修改進(jìn)行回溯 . 版本狀態(tài)列出的順序必須使得最新的版本列在最上邊 . 所有其它的信息包括輸入、輸出、限制、 以及過(guò)程調(diào)用等等 , 必須與最新的版本保持一致 . 編程常規(guī) 下面說(shuō)明了匯編語(yǔ)言指令中的標(biāo)準(zhǔn)結(jié)構(gòu) : 程序設(shè)計(jì)風(fēng)格 ? 應(yīng)該遵照 MIRCOSOFT MASM ~ TURBO ASMBLE ~。 版本狀態(tài)和歷史 給出當(dāng)日的日期 ,程序員姓名 . 入口參數(shù) 列出及描述所有該子過(guò)程將輸入的變量和寄存器，描述應(yīng)簡(jiǎn)要而完全 , 有必要描述一個(gè)組中不同的元素 , 或者一個(gè)詞的字節(jié)或位 . 如果沒(méi)有輸入變量 ,則鍵入“ none” . 出口參數(shù) 列出及描述所有該子過(guò)程的輸出變量和寄存器 , 同時(shí)描述對(duì)全局變量的 影響和被破壞的寄存器 , 如果有的話 . 同時(shí)還要描述出錯(cuò)信息或在出錯(cuò)時(shí)變量的值 , 如果沒(méi)有的話給出“ none” . 默認(rèn)的段寄存器和段名 用 ASSUME指出在該子過(guò)程中，默認(rèn)的段寄存器和段名的關(guān)系。 /*... ...*/ 匯編語(yǔ)言 產(chǎn)生新模塊代碼 圖 D2描述了產(chǎn)生匯編語(yǔ)言新模塊代碼的格式 , 在寫(xiě)新代碼之前 ,程序員必需首先將 件中 .然后編輯新文件以提供下列信息 . 目的 提供一個(gè)關(guān)于程序模塊的簡(jiǎn)要描述 . 版本狀態(tài) 給出當(dāng)日的日期 ,程序員姓名 ，版本號(hào)。則在 (1)中 plong=8,(2)中 plong=2。 (1) plong=(long *)(buf+2)。 long *plong。 ...。i9。 外部變量 ? 外部變量必須在函數(shù)中以 extern語(yǔ)句說(shuō)明 . ? 如果外部變量是數(shù)組 ,在外部說(shuō)明中 ,第一維必須為空 . ? 如果不同類型的變量要組在一起 ,用結(jié)構(gòu)取代數(shù)組 . ? 將外部變量說(shuō)明成 static類 , 如果它們?cè)谝粋€(gè)文件中共享而不被其它文件訪問(wèn) . 常量 ? 對(duì)公共使用的常量 ,引用 . for 循環(huán) 對(duì)于數(shù)組的處理 ,循環(huán)的結(jié)束用 取代 =.例 : int a[9]。比如： class 不是 C編譯器的關(guān)鍵字，但是 C++的關(guān)鍵字，在用 C編譯器開(kāi)發(fā)的系統(tǒng)中，不能采用 class作為變量名，否則將影響移植性。 ? 在用 malloc或 calloc申請(qǐng)空間之后 , 必須牢記在不需要它們的時(shí)候調(diào)用 free釋放空間以便于將來(lái)使用空間 . 類型說(shuō)明 ? 類型說(shuō)明的順序是由短到長(zhǎng) : char short long float double ? 盡量不使用 int, 用 short或 long取代 , 以免不同硬件環(huán)境的影響 . ? 僅僅使用 typedef定義的宏以便共享 . 變量名 變量名的長(zhǎng)度沒(méi)有限制 . 但各個(gè)變量的前 31個(gè)字符必須唯一 .(各 系統(tǒng)的狀態(tài)會(huì)有變化 ,盡可能在開(kāi)始時(shí)區(qū)分變量名 ). 建議用英文語(yǔ)句的一般風(fēng)格命名變量名 , 英文單詞的首字母大寫(xiě)，后面的字母小寫(xiě)。在編譯或連接器中要求大寫(xiě)的標(biāo)識(shí)符或庫(kù)函數(shù)名 . 3。 數(shù)據(jù)結(jié)構(gòu) 結(jié)構(gòu)名稱 描述 名 稱 定 義 描 述 使用特點(diǎn) 數(shù)據(jù)字典 數(shù)據(jù)字典和數(shù)據(jù)結(jié)構(gòu)圖可形成交互參照關(guān)系 名稱 定義 描述 使用特點(diǎn) 條件值C a s e 1C a s e 2C a s e 3比較A 、BA = BA BA B 項(xiàng)目計(jì)劃表 要求采用 PROJECT 軟件制作，大致格式如下： 項(xiàng)目名稱 標(biāo)識(shí)號(hào) 任務(wù) 工期 開(kāi)始時(shí)間 完成時(shí)間 提交件 負(fù)責(zé)人 擬制： 校對(duì)： 審核： 批準(zhǔn)： 第 頁(yè) 函數(shù) /過(guò)程接口 函數(shù)名 ：必須與源程序中的一致，包括大小寫(xiě) 功能 ：簡(jiǎn)要說(shuō)明該函數(shù) /過(guò)程實(shí)現(xiàn)的功能 ，以及主要的算法，對(duì)重要的函數(shù) /過(guò)程可采用偽語(yǔ)言進(jìn)行描述 入口參數(shù) ：對(duì)入口參數(shù)作簡(jiǎn)要的說(shuō)明，利用全局變量，則也要說(shuō)明 出口參數(shù) ：對(duì)出口參數(shù)作簡(jiǎn)要的說(shuō)明，改變了全局變量，則也要說(shuō)明 返回值 ：對(duì)函數(shù)的返回值說(shuō)明其類型和作用 程序設(shè)計(jì)的若干規(guī)定 這里例舉了 C 語(yǔ)言和匯編語(yǔ)言的規(guī)定，其他編程語(yǔ)言應(yīng)參照這些規(guī)定編寫(xiě) C語(yǔ)言 見(jiàn)附錄六 匯編語(yǔ)言 見(jiàn)附錄六 附錄六： 程 序 設(shè) 計(jì) 若 干 規(guī) 定 引言 本文檔描述了項(xiàng)目開(kāi)發(fā)中的編程標(biāo)準(zhǔn)，其目的是提供一個(gè)編程的嚴(yán)格規(guī)則，使得程序 有統(tǒng)一的風(fēng)格，以便于理解和維護(hù)，項(xiàng)目主要由 C語(yǔ)言和匯編語(yǔ)言編寫(xiě) . C 語(yǔ)言 產(chǎn)生新代碼 圖 D1描述了產(chǎn)生 C語(yǔ)言新代碼的格式，在寫(xiě)新代碼之前，程序員必需首先將 ，然后編輯新文件以提供下列信息 . 目的 提供一個(gè)關(guān)于程序的簡(jiǎn)要描述 . 版本狀態(tài) 給出當(dāng)日的日期，程序員姓名，創(chuàng)建或修改 . 輸入 列出及描述所有該程序?qū)⑤斎氲淖兞?，描述?yīng)簡(jiǎn)要而完全，有必要要描述一個(gè)組中不同的元素，或者一個(gè)詞的字節(jié)或位，如果沒(méi)有輸入變量 ,則鍵入 none. 輸出 列出及描述所有該函數(shù)的輸出變量，同時(shí)描述副作用，如果有的話 . 限制 簡(jiǎn)要說(shuō)明程序的限制，例如數(shù)組長(zhǎng)度，算法等等，同時(shí)給出對(duì)未來(lái)版本的建議，如果沒(méi)有限制，給出“ none” 錯(cuò)誤信息 描述出錯(cuò)信息或在出錯(cuò)時(shí)變量的置值，如果沒(méi)有的話給出“ none” . 方法 簡(jiǎn)單描述程序中所有調(diào)用的算法及方法，如果方法很明顯，則刪去這一項(xiàng)，如果應(yīng)用了復(fù)雜的算法或方程式，請(qǐng)給出解釋及參考 . 外部變量描述 僅列出及描述那些一般不為人所知的變量，如果該函數(shù)不用任何外部變量，給出“ none” . 局部、靜態(tài)、寄存器變量描述 列出及描述局部， 靜態(tài)寄存器變量，如果一個(gè)變量的用途可從其它變量名中明顯地看到，則不必給出解釋，變量名按字典順序列出 . /*********************************************************** * 本程序?qū)儆?XXXXXXXXX(公司名 ).作為商品機(jī)密 * * 版權(quán)所有 ,未經(jīng)許可不得公布或使用 . * ************************************************************ . 目的 函數(shù)的功能描述 . 版本狀態(tài) 11790(程序員姓名 )新代碼 .