【正文】 ng=(long *)buf+2。 (1) plong=(long *)(buf+2)。 (2) 如果buf=0。則在(1)中plong=8,(2)中plong=2。注釋 在需要明確程序含義的地方應(yīng)勤于使用注釋, 所有注釋寫(xiě)成:/*... ...*/或 // 在語(yǔ)句后的注釋必須與語(yǔ)句在同一行: statement /*..._ ..*/ statement /*..._ ..*/ 如果注釋太長(zhǎng), 超出一行,應(yīng)將其按如下格式放在語(yǔ)句之前: /*... ... ... ...*/ 如果變量需要注釋, 它們必須一行行地進(jìn)行說(shuō)明, 例如: int i。 /*... ...*/匯編語(yǔ)言產(chǎn)生新模塊代碼圖D2描述了產(chǎn)生匯編語(yǔ)言新模塊代碼的格式, 在寫(xiě)新代碼之前,.目的提供一個(gè)關(guān)于程序模塊的簡(jiǎn)要描述.版本狀態(tài)給出當(dāng)日的日期,程序員姓名，版本號(hào)。COMMENT % *********************************************************** * 本程序?qū)儆赬XXXXXXXX(公司名).作為商品機(jī)密 * * 版權(quán)所有,未經(jīng)許可不得公布或使用. * ***********************************************************. 目的 模塊的功能描述. 版本狀態(tài) 11790(程序員姓名)新代碼圖 D2 ASM標(biāo)準(zhǔn)格式(in “”)產(chǎn)生新的子過(guò)程代碼圖D3描述了產(chǎn)生匯編語(yǔ)言新的子過(guò)程代碼的格式,在寫(xiě)新子過(guò)程代碼之前,.子過(guò)程名稱(chēng)給出子過(guò)程的名稱(chēng)功能描述用語(yǔ)言或偽C代碼提供一個(gè)關(guān)于該子過(guò)程的簡(jiǎn)要描述,并且簡(jiǎn)要說(shuō)明子過(guò)程的限制。版本狀態(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)系。COMMENT . 子過(guò)程名稱(chēng) 給出子過(guò)程的名稱(chēng). 功能描述 提供一個(gè)關(guān)于子過(guò)程的簡(jiǎn)要描述，并且簡(jiǎn)要說(shuō)明子過(guò)程的限制.. 版本狀態(tài)和歷史 給出當(dāng)日的日期,程序員姓名.. 入口參數(shù) 列出及描述所有該子過(guò)程將輸入的變量和寄存器.. 出口參數(shù) 列出及描述所有該子過(guò)程的輸出變量和寄存器, 并列出被破壞的寄存器.. 默認(rèn)的段寄存器和段名 用ASSUME指出在該子過(guò)程中，默認(rèn)的段寄存器和段名的關(guān)系。%圖 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 ~ ASMBLE ~。建議不用簡(jiǎn)寫(xiě)方式. 在同一子過(guò)程中所有代碼必須是統(tǒng)一的小寫(xiě)字符和大寫(xiě)字母,以下的例外: (1) 宏必須用大寫(xiě)字母. (2) 在編譯或連接器中要求大寫(xiě)的標(biāo)識(shí)符或庫(kù)函數(shù)名. (3) 該文本中說(shuō)明的其它必須大寫(xiě)的字母. 對(duì)于一個(gè)程序只允許一個(gè)入口和出口（在有出錯(cuò)處理等情況下可能允許有若干個(gè)出口）. 設(shè)計(jì)的子程序必須有一個(gè)完整定義的輸出、輸入并且完成一個(gè)任務(wù). 將密切相關(guān)的子程序存放在一個(gè)文件中. 程序中盡量不使用直接數(shù), 即盡量不在源程序中出現(xiàn)某個(gè)具體的數(shù)值, 相應(yīng)的數(shù)值最好用EQU語(yǔ)句定義成宏, 以便于修改和維護(hù). 使用統(tǒng)一的工作環(huán)境, 建立子目錄, 各目錄存放指定的內(nèi)容: src (源程序存放目錄) doc (文檔存放目錄) bin (可執(zhí)行程序存放目錄) lib (庫(kù)函數(shù)存放目錄) test (測(cè)試用目錄) inc (引用文件存放目錄) personal (各人自用目錄) 使用統(tǒng)一的程序名后綴： .ASM (匯編源程序) .INC (公共的宏定義和結(jié)構(gòu)定義) .DOC (文檔) .LIB (函數(shù)庫(kù)) .BAT (批處理文件) .DAT (數(shù)據(jù)文件) .ROM (燒入EPROM的數(shù)據(jù)，在前綴中應(yīng)該指明芯片對(duì)應(yīng)的插座) 使用make, Makefile 進(jìn)行編譯, 更新目標(biāo)文件和可執(zhí)行文件.子過(guò)程名子過(guò)程名的長(zhǎng)度沒(méi)有限制. 但各個(gè)名稱(chēng)的前31個(gè)字符必須唯一.(各系統(tǒng)的狀態(tài)會(huì)有變化, 盡可能在開(kāi)始時(shí)加以區(qū)分).建議用英文語(yǔ)句的一般風(fēng)格命名過(guò)程名. 英文單詞的首字母大寫(xiě)，后面的字母小寫(xiě)。對(duì)于外部(公共)子過(guò)程名,在第一個(gè)字符之前加_.變量名變量名的長(zhǎng)度沒(méi)有限制. 但各個(gè)變量的前31個(gè)字符必須唯一.(各系統(tǒng)的狀態(tài)會(huì)有變化, 盡可能在開(kāi)始時(shí)加以區(qū)分).建議用英文語(yǔ)句的一般風(fēng)格命名變量名. 英文單詞的首字母大寫(xiě)，后面的字母小寫(xiě)。對(duì)于外部(公共)變量或函數(shù)名,在第一個(gè)字符之前加_,對(duì)局部的變量名, 建議遵照下列格式: bxxx_ 或 xxxx_b 字節(jié)變量 wxxx_ 或 xxxx_w 字變量 dxxx_ 或 xxxx_d 雙字變量 sbxxx 或 xxxx_sb 字節(jié)串變量 swxxx 或 xxxx_sw 字串變量 cxxx_ 或 xxxx_c 常量外部變量 . 如果不同類(lèi)型的變量要組在一起, 用結(jié)構(gòu)取代零散的變量.過(guò)程, 兩者之間有明顯的界限。常量對(duì)公共使用的常量, .標(biāo)號(hào) 所有標(biāo)號(hào)應(yīng)在第一列開(kāi)始. 標(biāo)號(hào)名稱(chēng)由子過(guò)程名稱(chēng)的簡(jiǎn)寫(xiě)(用大寫(xiě)字母)加下劃線加有具體含義的單詞構(gòu)成。注釋 在需要明確程序含義的地方應(yīng)勤于使用注釋, 所有注釋寫(xiě)成: 。xxxxx 在語(yǔ)句后的注釋必須與語(yǔ)句在同一行: statement 。..._ ... statement 。..._ ... 如果注釋太長(zhǎng), 超出一行,應(yīng)將其按如下格式放在語(yǔ)句之前: 。... 。... 。... 。... 每一個(gè)變量都應(yīng)以注釋, 對(duì)其用途、含義、可能的取值加以說(shuō)明。它們必須一行行地進(jìn)行說(shuō)明，例如: bxxxx DB ? 。... ... 帶注釋的指令不得少于整個(gè)程序指令數(shù)的三分之一. 在同一個(gè)文件中, 盡量將注釋對(duì)齊. 每實(shí)現(xiàn)一相對(duì)完整邏輯功能的一段指令前必須用注釋給出該功能的描述, 且各個(gè)該類(lèi)型指令段間用空行或注釋行分隔.35 / 35