【正文】 }void Init_Point( void ){ = 10。 = 10。 /* 初始化“點(diǎn)”的坐標(biāo) */}189。 621：如果多段代碼重復(fù)做同一件事情，那么在函數(shù)的劃分上可能存在問(wèn)題。說(shuō)明：若此段代碼各語(yǔ)句之間有實(shí)質(zhì)性關(guān)聯(lián)并且是完成同一件功能的，那么可考慮把此段代碼構(gòu)造成一個(gè)新的函數(shù)。189。 622：功能不明確較小的函數(shù)，特別是僅有一個(gè)上級(jí)函數(shù)調(diào)用它時(shí)，應(yīng)考慮把它合并到上級(jí)函數(shù)中，而不必單獨(dú)存在。說(shuō)明：模塊中函數(shù)劃分的過(guò)多，一般會(huì)使函數(shù)間的接口變得復(fù)雜。所以過(guò)小的函數(shù)，特別是扇入很低的或功能不明確的函數(shù)，不值得單獨(dú)存在。189。 623：設(shè)計(jì)高扇入、合理扇出（小于7）的函數(shù)。說(shuō)明：扇出是指一個(gè)函數(shù)直接調(diào)用（控制）其它函數(shù)的數(shù)目，而扇入是指有多少上級(jí)函數(shù)調(diào)用它。扇出過(guò)大，表明函數(shù)過(guò)分復(fù)雜，需要控制和協(xié)調(diào)過(guò)多的下級(jí)函數(shù)；而扇出過(guò)小，如總是1，表明函數(shù)的調(diào)用層次可能過(guò)多，這樣不利程序閱讀和函數(shù)結(jié)構(gòu)的分析，并且程序運(yùn)行時(shí)會(huì)對(duì)系統(tǒng)資源如堆?？臻g等造成壓力。函數(shù)較合理的扇出（調(diào)度函數(shù)除外）通常是35。扇出太大，一般是由于缺乏中間層次，可適當(dāng)增加中間層次的函數(shù)。扇出太小，可把下級(jí)函數(shù)進(jìn)一步分解多個(gè)函數(shù)，或合并到上級(jí)函數(shù)中。當(dāng)然分解或合并函數(shù)時(shí)，不能改變要實(shí)現(xiàn)的功能，也不能違背函數(shù)間的獨(dú)立性。扇入越大，表明使用此函數(shù)的上級(jí)函數(shù)越多，這樣的函數(shù)使用效率高，但不能違背函數(shù)間的獨(dú)立性而單純地追求高扇入。公共模塊中的函數(shù)及底層函數(shù)應(yīng)該有較高的扇入。較良好的軟件結(jié)構(gòu)通常是頂層函數(shù)的扇出較高，中層函數(shù)的扇出較少，而底層函數(shù)則扇入到公共模塊中。189。 624：減少函數(shù)本身或函數(shù)間的遞歸調(diào)用。說(shuō)明：遞歸調(diào)用特別是函數(shù)間的遞歸調(diào)用（如ABCA），影響程序的可理解性；遞歸調(diào)用一般都占用較多的系統(tǒng)資源（如?？臻g）；遞歸調(diào)用對(duì)程序的測(cè)試有一定影響。故除非為某些算法或功能的實(shí)現(xiàn)方便，應(yīng)減少?zèng)]必要的遞歸調(diào)用。189。 625：仔細(xì)分析模塊的功能及性能需求，并進(jìn)一步細(xì)分，同時(shí)若有必要畫(huà)出有關(guān)數(shù)據(jù)流圖，據(jù)此來(lái)進(jìn)行模塊的函數(shù)劃分與組織。說(shuō)明：函數(shù)的劃分與組織是模塊的實(shí)現(xiàn)過(guò)程中很關(guān)鍵的步驟，如何劃分出合理的函數(shù)結(jié)構(gòu)，關(guān)系到模塊的最終效率和可維護(hù)性、可測(cè)性等。根據(jù)模塊的功能圖或/及數(shù)據(jù)流圖映射出函數(shù)結(jié)構(gòu)是常用方法之一。189。 626：改進(jìn)模塊中函數(shù)的結(jié)構(gòu)，降低函數(shù)間的耦合度，并提高函數(shù)的獨(dú)立性以及代碼可讀性、效率和可維護(hù)性。優(yōu)化函數(shù)結(jié)構(gòu)時(shí)，要遵守以下原則：（1）不能影響模塊功能的實(shí)現(xiàn)。（2）仔細(xì)考查模塊或函數(shù)出錯(cuò)處理及模塊的性能要求并進(jìn)行完善。（3）通過(guò)分解或合并函數(shù)來(lái)改進(jìn)軟件結(jié)構(gòu)。（4）考查函數(shù)的規(guī)模，過(guò)大的要進(jìn)行分解。（5）降低函數(shù)間接口的復(fù)雜度。（6）不同層次的函數(shù)調(diào)用要有較合理的扇入、扇出。（7）函數(shù)功能應(yīng)可預(yù)測(cè)。（8）提高函數(shù)內(nèi)聚。（單一功能的函數(shù)內(nèi)聚最高）說(shuō)明：對(duì)初步劃分后的函數(shù)結(jié)構(gòu)應(yīng)進(jìn)行改進(jìn)、優(yōu)化，使之更為合理。189。 627：在多任務(wù)操作系統(tǒng)的環(huán)境下編程，要注意函數(shù)可重入性的構(gòu)造。說(shuō)明：可重入性是指函數(shù)可以被多個(gè)任務(wù)進(jìn)程調(diào)用。在多任務(wù)操作系統(tǒng)中，函數(shù)是否具有可重入性是非常重要的，因?yàn)檫@是多個(gè)進(jìn)程可以共用此函數(shù)的必要條件。另外，編譯器是否提供可重入函數(shù)庫(kù)，與它所服務(wù)的操作系統(tǒng)有關(guān)，只有操作系統(tǒng)是多任務(wù)時(shí)，編譯器才有可能提供可重入函數(shù)庫(kù)。如DOS下BC和MSC等就不具備可重入函數(shù)庫(kù)，因?yàn)镈OS是單用戶(hù)單任務(wù)操作系統(tǒng)。189。 628：避免使用BOOL參數(shù)。說(shuō)明：原因有二，其一是BOOL參數(shù)值無(wú)意義，TURE/FALSE的含義是非常模糊的，在調(diào)用時(shí)很難知道該參數(shù)到底傳達(dá)的是什么意思；其二是BOOL參數(shù)值不利于擴(kuò)充。還有NULL也是一個(gè)無(wú)意義的單詞。189。 629： 對(duì)于提供了返回值的函數(shù)，在引用時(shí)最好使用其返回值。189。 630：當(dāng)一個(gè)過(guò)程（函數(shù)）中對(duì)較長(zhǎng)變量（一般是結(jié)構(gòu)的成員）有較多引用時(shí)，可以用一個(gè)意義相當(dāng)?shù)暮甏妗?說(shuō)明：這樣可以增加編程效率和程序的可讀性。示例：在某過(guò)程中較多引用TheReceiveBuffer[FirstSocket].byDataPtr，則可以通過(guò)以下宏定義來(lái)代替： define pSOCKDATA TheReceiveBuffer[FirstScoket].byDataPtr7 可測(cè)性185。 71：在同一項(xiàng)目組或產(chǎn)品組內(nèi)，要有一套統(tǒng)一的為集成測(cè)試與系統(tǒng)聯(lián)調(diào)準(zhǔn)備的調(diào)測(cè)開(kāi)關(guān)及相應(yīng)打印函數(shù)，并且要有詳細(xì)的說(shuō)明。說(shuō)明：本規(guī)則是針對(duì)項(xiàng)目組或產(chǎn)品組的。185。 72：在同一項(xiàng)目組或產(chǎn)品組內(nèi)，調(diào)測(cè)打印出的信息串的格式要有統(tǒng)一的形式。信息串中至少要有所在模塊名（或源文件名）及行號(hào)。說(shuō)明：統(tǒng)一的調(diào)測(cè)信息格式便于集成測(cè)試。185。 73：編程的同時(shí)要為單元測(cè)試選擇恰當(dāng)?shù)臏y(cè)試點(diǎn)，并仔細(xì)構(gòu)造測(cè)試代碼、測(cè)試用例，同時(shí)給出明確的注釋說(shuō)明。測(cè)試代碼部分應(yīng)作為（模塊中的）一個(gè)子模塊，以方便測(cè)試代碼在模塊中的安裝與拆卸（通過(guò)調(diào)測(cè)開(kāi)關(guān)）。說(shuō)明：為單元測(cè)試而準(zhǔn)備。185。 74：在進(jìn)行集成測(cè)試/系統(tǒng)聯(lián)調(diào)之前，要構(gòu)造好測(cè)試環(huán)境、測(cè)試項(xiàng)目及測(cè)試用例，同時(shí)仔細(xì)分析并優(yōu)化測(cè)試用例，以提高測(cè)試效率。說(shuō)明：好的測(cè)試用例應(yīng)盡可能模擬出程序所遇到的邊界值、各種復(fù)雜環(huán)境及一些極端情況等。185。 75：使用斷言來(lái)發(fā)現(xiàn)軟件問(wèn)題，提高代碼可測(cè)性。說(shuō)明：斷言是對(duì)某種假設(shè)條件進(jìn)行檢查（可理解為若條件成立則無(wú)動(dòng)作，否則應(yīng)報(bào)告），它可以快速發(fā)現(xiàn)并定位軟件問(wèn)題，同時(shí)對(duì)系統(tǒng)錯(cuò)誤進(jìn)行自動(dòng)報(bào)警。斷言可以對(duì)在系統(tǒng)中隱藏很深，用其它手段極難發(fā)現(xiàn)的問(wèn)題進(jìn)行定位，從而縮短軟件問(wèn)題定位時(shí)間，提高系統(tǒng)的可測(cè)性。實(shí)際應(yīng)用時(shí)，可根據(jù)具體情況靈活地設(shè)計(jì)斷言。示例：下面是C語(yǔ)言中的一個(gè)斷言，用宏來(lái)設(shè)計(jì)的。（其中NULL為0L）ifdef _EXAM_ASSERT_TEST_ // 若使用斷言測(cè)試void exam_assert( char * file_name, unsigned int line_no ){ printf( \n[EXAM]Assert failed: %s, line %u\n, file_name, line_no )。 abort( )。}define EXAM_ASSERT( condition ) if (condition) // 若條件成立，則無(wú)動(dòng)作 NULL。 else // 否則報(bào)告 exam_assert( __FILE__, __LINE__ ) else // 若不使用斷言測(cè)試define EXAM_ASSERT(condition) NULL endif /* end of ASSERT */185。 76：用斷言來(lái)檢查程序正常運(yùn)行時(shí)不應(yīng)發(fā)生但在調(diào)測(cè)時(shí)有可能發(fā)生的非法情況。185。 77：不能用斷言來(lái)檢查最終產(chǎn)品肯定會(huì)出現(xiàn)且必須處理的錯(cuò)誤情況。說(shuō)明：斷言是用來(lái)處理不應(yīng)該發(fā)生的錯(cuò)誤情況的，對(duì)于可能會(huì)發(fā)生的且必須處理的情況要寫(xiě)防錯(cuò)程序，而不是斷言。如某模塊收到其它模塊或鏈路上的消息后，要對(duì)消息的合理性進(jìn)行檢查，此過(guò)程為正常的錯(cuò)誤檢查，不能用斷言來(lái)實(shí)現(xiàn)。185。 78：對(duì)較復(fù)雜的斷言加上明確的注釋。說(shuō)明：為復(fù)雜的斷言加注釋?zhuān)沙吻鍞嘌院x并減少不必要的誤用。185。 79：用斷言確認(rèn)函數(shù)的參數(shù)。示例：假設(shè)某函數(shù)參數(shù)中有一個(gè)指針，那么使用指針前可對(duì)它檢查，如下。int exam_fun( unsigned char *str ){ EXAM_ASSERT( str != NULL )。 // 用斷言檢查“假設(shè)指針不為空”這個(gè)條件 ... //other program code}185。 710：用斷言保證沒(méi)有定義的特性或功能不被使用。示例：假設(shè)某通信模塊在設(shè)計(jì)時(shí)，準(zhǔn)備提供“無(wú)連接”和“連接” 這兩種業(yè)務(wù)。但當(dāng)前的版本中僅實(shí)現(xiàn)了“無(wú)連接”業(yè)務(wù)，且在此版本的正式發(fā)行版中，用戶(hù)（上層模塊）不應(yīng)產(chǎn)生“連接”業(yè)務(wù)的請(qǐng)求，那么在測(cè)試時(shí)可用斷言檢查用戶(hù)是否使用“連接”業(yè)務(wù)。如下。define EXAM_CONNECTIONLESS 0 // 無(wú)連接業(yè)務(wù)define EXAM_CONNECTION 1 // 連接業(yè)務(wù)int msg_process( EXAM_MESSAGE *msg ){ unsigned char service。 /* message service class */ EXAM_ASSERT( msg != NULL )。service = get_msg_service_class( msg )。 EXAM_ASSERT( service != EXAM_CONNECTION )。 // 假設(shè)不使用連接業(yè)務(wù) ... //other program code}185。 711：用斷言對(duì)程序開(kāi)發(fā)環(huán)境（OS/Compiler/Hardware）的假設(shè)進(jìn)行檢查。說(shuō)明：程序運(yùn)行時(shí)所需的軟硬件環(huán)境及配置要求，不能用斷言來(lái)檢查，而必須由一段專(zhuān)門(mén)代碼處理。用斷言?xún)H可對(duì)程序開(kāi)發(fā)環(huán)境中的假設(shè)及所配置的某版本軟硬件是否具有某種功能的假設(shè)進(jìn)行檢查。如某網(wǎng)卡是否在系統(tǒng)運(yùn)行環(huán)境中配置了，應(yīng)由程序中正式代碼來(lái)檢查；而此網(wǎng)卡是否具有某設(shè)想的功能，則可由斷言來(lái)檢查。對(duì)編譯器提供的功能及特性假設(shè)可用斷言檢查，原因是軟件最終產(chǎn)品（即運(yùn)行代碼或機(jī)器碼）與編譯器已沒(méi)有任何直接關(guān)系，即軟件運(yùn)行過(guò)程中（注意不是編譯過(guò)程中）不會(huì)也不應(yīng)該對(duì)編譯器的功能提出任何需求。示例：用斷言檢查編譯器的int型數(shù)據(jù)占用的內(nèi)存空間是否為2，如下。EXAM_ASSERT( sizeof( int ) == 2 )。185。 712：正式軟件產(chǎn)品中應(yīng)把斷言及其它調(diào)測(cè)代碼去掉（即把有關(guān)的調(diào)測(cè)開(kāi)關(guān)關(guān)掉）。說(shuō)明：加快軟件運(yùn)行速度。185。 713：在軟件系統(tǒng)中設(shè)置與取消有關(guān)測(cè)試手段，不能對(duì)軟件實(shí)現(xiàn)的功能等產(chǎn)生影響。說(shuō)明：即有測(cè)試代碼的軟件和關(guān)掉測(cè)試代碼的軟件，在功能行為上應(yīng)一致。185。 714：用調(diào)測(cè)開(kāi)關(guān)來(lái)切換軟件的DEBUG版和正式版，而不要同時(shí)存在正式版本和DEBUG版本的不同源文件，以減少維護(hù)的難度。185。 715：軟件的DEBUG版本和發(fā)行版本應(yīng)該統(tǒng)一維護(hù)，不允許分家，并且要時(shí)刻注意保證兩個(gè)版本在實(shí)現(xiàn)功能上的一致性。189。 71：在編寫(xiě)代碼之前，應(yīng)預(yù)先設(shè)計(jì)好程序調(diào)試與測(cè)試的方法和手段，并設(shè)計(jì)好各種調(diào)測(cè)開(kāi)關(guān)及相應(yīng)測(cè)試代碼如打印函數(shù)等。說(shuō)明：程序的調(diào)試與測(cè)試是軟件生存周期中很重要的一個(gè)階段，如何對(duì)軟件進(jìn)行較全面、高率的測(cè)試并盡可能地找出軟件中的錯(cuò)誤就成為很關(guān)鍵的問(wèn)題。因此在編寫(xiě)源代碼之前，除了要有一套比較完善的測(cè)試計(jì)劃外，還應(yīng)設(shè)計(jì)出一系列代碼測(cè)試手段，為單元測(cè)試、集成測(cè)試及系統(tǒng)聯(lián)調(diào)提供方便。189。 72：調(diào)測(cè)開(kāi)關(guān)應(yīng)分為不同級(jí)別和類(lèi)型。說(shuō)明：調(diào)測(cè)開(kāi)關(guān)的設(shè)置及分類(lèi)應(yīng)從以下幾方面考慮：針對(duì)模塊或系統(tǒng)某部分代碼的調(diào)測(cè)；針對(duì)模塊或系統(tǒng)某功能的調(diào)測(cè)；出于某種其它目的，如對(duì)性能、容量等的測(cè)試。這樣做便于軟件功能的調(diào)測(cè)，并且便于模塊的單元測(cè)試、系統(tǒng)聯(lián)調(diào)等。189。 73：編寫(xiě)防錯(cuò)程序，然后在處理錯(cuò)誤之后可用斷言宣布發(fā)生錯(cuò)誤。示例：假如某模塊收到通信鏈路上的消息，則應(yīng)對(duì)消息的合法性進(jìn)行檢查，若消息類(lèi)別不是通信協(xié)議中規(guī)定的，則應(yīng)進(jìn)行出錯(cuò)處理，之后可用斷言報(bào)告，如下例。ifdef _EXAM_ASSERT_TEST_ // 若使用斷言測(cè)試/* Notice: this function does not call 39。abort39。 to exit program */void assert_report( char * file_name, unsigned int line_no ){ printf( \n[EXAM]Error Report: %s, line %u\n, file_name, line_no )。}define ASSERT_REPORT( condition ) if ( condition ) // 若條件成立，則無(wú)動(dòng)作 NULL。 else // 否則報(bào)告 assert_report ( __FILE__, __LINE__ ) else // 若不使用斷言測(cè)試define ASSERT_REPORT( condition ) NULL endif /* end of ASSERT */int msg_handle( unsigned char msg_name, unsigned char * msg ){ switch( msg_name ) { case MSG_ONE: ... // 消息MSG_ONE處理 return MSG_HANDLE_SUCCESS。 ... // 其它合法消息處理 default: ... // 消息出錯(cuò)處理 ASSERT_REPORT( FALSE )。 // “合法”消息不成立，報(bào)告 return MSG_HANDLE_ERROR。 }}8 程序效率185。 81：編程時(shí)要經(jīng)常注意代碼的效率。說(shuō)明：代碼效率分為全局效率、局部效率、時(shí)間效率及空間效率。全局效率是站在整個(gè)系統(tǒng)的角度上的系統(tǒng)效率；局部效率是站在模塊或函數(shù)角度上的效率；時(shí)間效率是程序處理輸入任務(wù)所需的時(shí)間長(zhǎng)短；空間效率是程序所需內(nèi)存空間，如機(jī)器代碼空間大小、數(shù)據(jù)空間大小、?？臻g大小等。185。 82：在保證軟件系統(tǒng)的正確性、穩(wěn)定性、可讀性及可測(cè)性的前提下，提高代碼效率。說(shuō)明：不能一味地