【正文】 它們必須一行行地進行說明，例如 : bxxxx DB ? 。... 。... 。..._ ... statement 。 注釋 ? 在需要明確程序含義的地方應(yīng)勤于使用注釋 , 所有注釋寫成 : 。對于外部 (公共 )變量或函數(shù)名 ,在第一個字符之前加 _,對局部的變量名 , 建議遵照下列格式 : bxxx_ 或 xxxx_b 字節(jié)變量 wxxx_ 或 xxxx_w 字變量 dxxx_ 或 xxxx_d 雙字變量 sbxxx 或 xxxx_sb 字節(jié)串變量 swxxx 或 xxxx_sw 字串 變量 cxxx_ 或 xxxx_c 常量 外部變量 ? 外部變量必須在模塊中以 extrn語句說明 .所有的外部變量集中在一起放在文件的開始處 . ? 如果不同類型的變量要組在一起 , 用結(jié)構(gòu)取代零散的變量 . 過程 引用的外部過程必須在模塊以 extrn語句說明 .所有的外部過程集中在一起放在外部變量之后 , 兩者之間有明顯的界限。建議不用簡寫方式 . ? 在同一子過程中所有代碼必須是統(tǒng)一的小寫字符和大寫字母 ,以下的例外 : (1) 宏必須用 大寫字母 . (2) 在編譯或連接器中要求大寫的標識符或庫函數(shù)名 . (3) 該文本中說明的其它必須大寫的字母 . ? 對于一個程序只允許一個入口和出口（在有出錯處理等情況下可能允許有若干個出口） . ? 設(shè)計的子程序必須有一個完整定義的輸出、輸入并且完成一個任務(wù) . ? 將密切相關(guān)的子程序存放在一個文件中 . ? 程序中盡量不使用直接數(shù) , 即盡量不在源程序中出現(xiàn)某個具體的數(shù)值 , 相應(yīng)的數(shù)值最好用 EQU語句定義成宏 , 以便于修改和維護 . ? 使用統(tǒng)一的工作環(huán)境 , 建立子目錄 , 各目錄存放指定的內(nèi)容 : src (源程序存放目錄 ) doc (文檔存放目錄 ) bin (可執(zhí)行程序存放目錄 ) 企業(yè) () 大量的管理資料下載 lib (庫函數(shù)存放目錄 ) test (測試用目錄 ) inc (引用文件存放目錄 ) personal (各人自用目錄 ) ? 使用統(tǒng)一的程序名后綴： .ASM (匯編源程序 ) .INC (公共的宏定義和結(jié)構(gòu)定義 ) .DOC (文檔 ) .LIB (函數(shù)庫 ) .BAT (批處理文件 ) .DAT (數(shù)據(jù)文 件 ) .ROM (燒入 EPROM的數(shù)據(jù)，在前綴中應(yīng)該指明芯片對應(yīng)的插座 ) ? 使用 make, Makefile 進行編譯 , 更新目標文件和可執(zhí)行文件 . 子過程名 子過程名的長度沒有限制 . 但各個名稱的前 31個字符必須唯一 .(各系統(tǒng)的狀態(tài)會有變化 , 盡可能在開始時加以區(qū)分 ).建議用英文語句的一般風格命名過程名 . 英文單詞的首字母大寫，后面的字母小寫。 COMMENT . 子過程名稱 給出子過程的名稱 . 功能描述 提供一個關(guān)于子過程的簡要描述，并且簡要說明子過程的限制 . . 版本狀態(tài)和歷史 給出當日的日期 ,程序員姓名 . . 入口參數(shù) 列出及描述所有該 子過程將輸入的變量和寄存器 . . 出口參數(shù) 列出及描述所有該子過程的輸出變量和寄存器 , 并列出被破壞的寄存器 . . 默認的段寄存器和段名 用 ASSUME 指出在該子過程中，默認的段寄存器和段名的關(guān)系。 COMMENT % *********************************************************** * 本程序?qū)儆?XXXXXXXXX(公司名 ).作為商品機密 * * 版權(quán)所有 ,未經(jīng)許可不得公布或使用 . * *********************************************************** . 目的 模塊的功能描述 . 版本狀態(tài) 11790(程序員姓名 )新代碼 圖 D2 ASM 標準格式 (in “ ” ) 產(chǎn)生新的子過程代 碼 圖 D3描述了產(chǎn)生匯編語言新的子過程代碼的格式 ,在寫新子過程代碼之前 ,程序員必需首先將 拷貝到新子過程前 .然后編輯新文件以提供下列信息 . 子過程名稱 給出子過程的名稱 功能描述 用語言或偽 C代碼提供一個關(guān)于該子過程的簡要描述 ,并且簡要說明子過程的限制。 注釋 ? 在需要明確程序 含義的地方應(yīng)勤于使用注釋 , 所有注釋寫成 :/*... ...*/或 // ? 在語句后的注釋必須與語句在同一行 : statement /*..._ ..*/ statement /*..._ ..*/ ? 如果注釋太長 , 超出一行 ,應(yīng)將其按如下格式放在語句之前 : /*... ... ... ...*/ ? 如果變量需要注釋 , 它們必須一行行地進行說明 , 例如 : int i。 (2) 如果 buf=0。 plong=(long *)buf+2。 if_else 有 else if的語句 ,應(yīng)將 if提上一行 ,例如 : if( ) { ……… . } else if { ……… . } 標號 所有標號應(yīng)在第一列開始 企業(yè) () 大量的管理資料下載 goto 除非絕對必要 , 避免使用 goto default 在 switch語句中將 default放在 case的最后 break ? 在 switch語句之外盡量少用 break. ? 在某些循環(huán)中為減少代碼層次可有限地使用 break 和 continue. 返回 return ? 即使不返回任何值 , 也應(yīng)在函數(shù)的出口處寫上 return以示函數(shù)出口 ? 盡量在一個函數(shù)中使用一個 return, 個別情況例外 (如有多個錯誤處理時 ). 大括號 用大括號將一些語句組在一起 小括號 用 （ ） 避免操作順序的混亂 .特別要注意以下兩點的應(yīng)用（通過例子來說明） ,也是程序設(shè)計中經(jīng)常不注意而犯的錯誤 ： define x y+3 (1) define x (y+3) (2) 按 (1)的定義 z=x/3〉 z=y+3/3=y+1 按 (2)的定義 z=x/3 z=(y+3)/3=y/3=1 char *buf。i++) ...。 for (i=0。 寄存器變量 在程序中找一個頻繁使用的變量 (int或指針類型 ),將其定義成寄存器類以加快運行速度，特別適用于循環(huán)變量中。對于外部 (公共 )變量或函數(shù)名 , 在第一個字符之前加 _, 對局部的變量名 , 建議遵照下列格式 : bxxx_或 xxxx_b 字節(jié)變量 cxxx_或 xxxx_c 字符變量 ixxx_或 xxxx_i 數(shù)變量 sxxx_或 xxxx_s 字變量 lxxx_或 xxxx_l 長變量 企業(yè) () 大量的管理資料下載 fxxx_或 xxxx_f 浮點變量 dxxx_或 xxxx_d 精變量 fpxxx 或 xxxx_fp 文件指針 xpxxx 或 xxxx_xp 指針變量 (例 :ipxxxx 或 xxxx_ip) 注意：變量名不應(yīng)該和當前系統(tǒng)采用的編譯器，以及與已知的其他編譯器中已定義的函數(shù)名或 C的庫函數(shù)相同，也不應(yīng)與同 C的關(guān)鍵字相同。該文本中說明的其它必須大寫的字母 . ? 代碼盡可能寫得簡單、清晰、將復(fù)雜語句切成幾個簡單的語句以增加可讀性 . ? 一般將子程序限制在 100行以內(nèi) . ? 對于一個程序只允許一個入口和出口（在有出錯處理等情況下可能允許有若干個出口） . ? 設(shè)計的子程序必須有一個完整定義的輸出、輸入并且完成一個任務(wù) . ? 將密切相關(guān)的子程序存放在一個文件中 . ? 程序中盡量不使用直接數(shù) , 即盡量不在源程序中出現(xiàn)某個具體的數(shù)值 , 相應(yīng)的數(shù)值最好用define語句