匯編語言編程規(guī)范

《匯編語言編程規(guī)范》由會員上傳分享，免費在線閱讀，更多相關內容在學術論文-天天文庫。

1、軟件設計更多地是一種工程，而不是一種個人藝術。如果不統(tǒng)一編程規(guī)范，最終寫出的程序，其可讀性將較差，這不僅給代碼的理解帶來障礙，增加維護階段的工作量，同時不規(guī)范的代碼隱含錯誤的可能性也比較大。分析表明，編碼階段產生的錯誤當中，語法錯誤大概占20%左右，而由于未嚴格檢查軟件邏輯導致的錯誤、函數(shù)（模塊）之間接口錯誤及由于代碼可理解度低導致優(yōu)化維護階段對代碼的錯誤修改引起的錯誤則占了一半以上?？梢姡岣哕浖|量必須降低編碼階段的錯誤率。如何有效降低編碼階段的錯誤呢？這需要制定詳細的軟件編程規(guī)范，并培訓每一位程序員，最終的結果可以把編碼階段的錯誤降至10%左右，同時也降

2、低了程序的測試費用，效果相當顯著。本文從代碼的可維護性（可讀性、可理解性、可修改性）、代碼邏輯與效率、函數(shù)（模塊）接口、可測試性四個方面闡述了軟件編程規(guī)范，規(guī)范分成規(guī)則和建議兩種，其中規(guī)則部分為強制執(zhí)行項目，而建議部分則不作強制，可根據習慣取舍。1．排版規(guī)則1程序塊使用縮進方式，函數(shù)和標號使用空格縮進，程序段混合使用TAB和空格縮進?？s進的目的是使程序結構清晰，便于閱讀和理解。默認寬度應為8個空格，由于Word中為4個空格，為示范清晰，此處用2個代替(下同)。例如：MOVR1,#00HMOVR2,#00HMOVPMR,#PMRNO

3、RMALMOVDPS,#FLAGDPTRMOVDPTR,#ADDREEPROMread1kloop:read1kpage:INCR1MOVXA,@DPTRMOVSBUF,AJNBTI,$CLRTIINCDPTRCJNER1,#20H,read1kpageINCR2MOVR1,#00HCPLWDICJNER2,#20H,read1kloop;ENDOFEEPROM規(guī)則2在指令的操作數(shù)之間的，使用空格進行間隔，采用這種松散方式編寫代碼的目的是使代碼更加清晰。例如：CJNER2,#20H,read1kloop;ENDOFEEPROM規(guī)則3一行最多寫一條語句。規(guī)則4變

4、量定義時，保持對齊。便于閱讀和檢查內存的使用情況。例如：RegLEDLOSSEQU30H;VARIABLE;TESTLED==RegLEDLOSS.0RegLEDRAEQU31H;VARIABLERUNLED_FlagEQU32H;VARIABLE;256ms改變一次RUNLED狀態(tài)RUNLED_DefEQU10H;STATIC;16*32ms=500ms改變一次LED狀態(tài)2．注釋注釋的原則是有助于對程序的閱讀理解，注釋不宜太多也不能太少，太少不利于代碼理解，太多則會對閱讀產生干擾，因此只在必要的地方才加注釋，而且注釋要準確、易懂、盡可能簡潔。注釋量一般控制在

5、30%到50%之間。規(guī)則1程序在必要的地方必須有注釋，注釋要準確、易懂、簡潔。例如如下注釋意義不大：MOVDXCE1COUNTER,#00H;將DXCE1COUNTER賦值為0而如下的注釋則給出了額外有用的信息：JNZPcComm_Err;假如校驗出錯規(guī)則2注釋應與其描述的代碼相近，對代碼的注釋應放在其上方或右方（對單條語句的注釋）相鄰位置，不可放在下面，如放于上方則需與其上面的代碼用空行隔開。規(guī)則3頭文件、源文件的頭部，應進行注釋。注釋必須列出：文件名、作者、目的、功能、修改日志等。規(guī)則4函數(shù)頭部應進行注釋，列出：函數(shù)的目的、功能、輸入參數(shù)、輸出參數(shù)、涉及到

6、的通用變量和寄存器、調用的其他函數(shù)和模塊、修改日志等。對一些復雜的函數(shù)，在注釋中最好提供典型用法。規(guī)則5對重要代碼段的功能、意圖進行注釋，提供有用的、額外的信息。并在該代碼段的結束處加一行注釋表示該段代碼結束。規(guī)則6對于所有的常量，變量，數(shù)據結構聲明(包括數(shù)組、結構、類、枚舉等)，如果其命名不是充分自注釋的，在聲明時都必須加以注釋，說明其含義。規(guī)則7維護代碼時，要更新相應的注釋，刪除不再有用的注釋。保持代碼、注釋的一致性，避免產生誤解。3．命名規(guī)則1標識符縮寫形成縮寫的幾種技術：1)去掉所有的不在詞頭的元音字母。如screen寫成scrn,primtive寫成

7、prmv。2)使用每個單詞的頭一個或幾個字母。如ChannelActivation寫成ChanActiv，ReleaseIndication寫成RelInd。3)使用變量名中每個有典型意義的單詞。如CountofFailure寫成FailCnt。4)去掉無用的單詞后綴ing,ed等。如PagingRequest寫成PagReq。5)使用標準的或慣用的縮寫形式（包括協(xié)議文件中出現(xiàn)的縮寫形式）。如BSIC(BaseStationIdentificationCode)、MAP(MobileApplicationPart)。關于縮寫的準則：1)縮寫應該保持一致性。如C

8、hannel不要有時縮寫成Chan，有