【正文】 應書寫為： MQMD md = { MQMD_DEFAULT }。 memcpy(amp。m_pmo, amp。md, sizeof(md))。 空格與空行規(guī)則 32: 相鄰兩個功能相對獨立的代碼塊間應使用空行隔開。應書寫為： int* p = amp。例：int *p = amp。例：if (!IsQuit()) exit(0)。應書寫為：m_bIsConnected = FALSE。建議 9: 定義多個宏或初始化多個變量時，將 值對齊。應書寫為： = 0。例： = 0。劃分出的新行要進行適當?shù)目s進，使排版整齊，語句易讀。應書寫為：int nRetCode。例：if (!IsQuit()) { exit(0)。 } … }return 0。 bAutoReadBodyFile) { // Auto read the body file. CBuffedFile reader。 int nRetCode = Patch(pMsg)。 // 解讀報文塊// 20220902 lny modify: 增加自動讀取報體文件功能。 if (lpErrText!=NULL) s = lpErrText。對代碼塊進行修改的，還應標明修改結(jié)束的位置。 * ExitOnFail()。 * (() strlen(MBT_FILE) strlen(MBT_SUFFIX))。 // 其他報文塊 // 目前沒有這樣的塊，做錯塊 CString s。 // 正文塊檢查 if( bMustData amp。 CString strWrkStr。 default: // DO NOTHING break。 break。 ii8。 ii8。 char sTmpStr[17]。 memset(p, 0, nOutLen)。} // 清除行計數(shù) static int nLineChars = 0。規(guī)則 26: 語句塊注釋應遵循下列原則：? 應使用斷行注釋，即//；? 一目了然的語句不應注釋；? 每個分支、每個功能段均 應注釋；? 應放置在緊臨該語句塊上方或語句右側(cè)，與其上方的語句塊應留一空行，禁止放置在語句塊的下方，但可以在語句 塊下方放置該語句塊結(jié)束的注 釋。如該函數(shù)或方法重載，則應必須使用參數(shù)（類型）列表，如 GetTag(LPCSTR, AMOUNTamp。*/? 需要生成圓點列表時使用－，需要生成 編號列表時使用－ 。如：/** * … * * par 算法原理： * 計算機內(nèi)部運算使用的基數(shù)是 2，即滿 2 進位。每個業(yè)務塊由一個定長的業(yè)務頭( CMTBusinessHeader )與一個變長正文塊( CMTBusinessData ) 組成； * 正文塊( CMTBusinessData )由一個或多個 TAG 碼:TAG 值對(報文域)組成，部分TAG 值 又可由多個定 長子域 組成； * 正文體可放置在報 文中，也可存儲在文件中，而在報文中僅放置文件名； * 當正文體在文件中，則說明批量業(yè)務頭、 業(yè)務頭、正文塊存儲在文件中。 * * par 計算公式： * code * 最大 長度 = MQCMT 消息長度 sizeof(CMTMsgHeader) sizeof(CMTMsgTail) sizeof(MQMsg) +1 * = MQCMT 最大消息長度 175 * endcode * 目前，MQCMT 類定義的最大消息 長度為 1M=1048576 字節(jié)。 宏與變量注釋規(guī)則 24: 宏與變量使用簡單注釋或斷行注釋。 /// 保留域。 /// 報文提交時間，保留，格式為 HHMISS。 /// 報文時間，格式為 YYYYMMDDHHMISS。 /// 報文參考號，報文發(fā)起人生成，回應報文帶回進行報文匹配。 /// 輸出標識，保留。 /// 報文目標地址，即報文接收人。 /// 業(yè)務碼 0 位(系統(tǒng)號) 13 位 CMT 號 4 位 節(jié)點 57 位 保留。 /// 版本號，保留 = 0。注釋格式如下：例：/** 報頭結(jié)構(gòu)，總長度 138 字節(jié)。 /// 直接設置的報體串 CMTMsgHeader m_Header。 數(shù)據(jù)成員注釋規(guī)則 22: 類的每個數(shù)據(jù)成員均使用斷行注釋。 * param [in] sBankCode 行號； * param [in] sPassword 密 碼。stSet, SIGHUP)。 * note 如果要添加多個信號，則必須使用 0 作為最后一個信號。 * 詳細說明 1； * 詳細說明 2。注 釋格式如下：/** * brief 函數(shù)功能 簡要說明 * param [in|out] 參數(shù)名稱 1 參數(shù) 1 簡要說明；* param [in|out] 參數(shù)名稱 2 參數(shù) 2 簡要說明。注 釋格式如下：/** * brief 類簡 要說明 * * 類詳細說明 * * par 其他重要信息* 其他重要信息說明** par 變更歷 史： * 時間 作者 修改說明*/例：/** * brief UNIX 信號處理函數(shù)封裝類 * * 本類封裝部分 UNIX 信號處理函數(shù)，簡化在 UNIX 下編寫信號處理程序的編碼難度。 ** author * 20220305 lny 創(chuàng)建初始版本 * 20220307 lny 添加文檔注釋信息 * version* 20220305 創(chuàng)建初始版本 * 20220307 添加文檔注釋信息 * * warning 本 類不能在 WIN32 操作系統(tǒng)使用。 一一一 注釋規(guī)則 18: 程序代碼中增加注釋的目標是幫助對程序的閱讀理解，不宜太多或太少，太多則會對閱讀產(chǎn)生干擾，太少則不利于代 碼理解，因此只在必要的地方才加注釋，且準確、易懂、簡潔。但數(shù)字是短 語一部分的，可以使用，如 KillSigusr2()。 函數(shù)命名規(guī)則 17: 函數(shù)命名應使用能夠表達函數(shù)功能的英文動詞或動賓結(jié)構(gòu)短語，且每個單詞的首字母大寫。如：ifdef _NONE_THROW_endif…ifndef _FOR_CCPC_endif規(guī)則 15: 為防止重復包含而定義的頭文件預處理宏，應使用__NAME_HPP__（C++）或__NAME_H__（C）形式，其中 NAME 為模塊名稱。其中，作用域范圍前綴、前綴以小寫字母表示且可選，基本類型以小寫字母表示且必選。 簡稱應遵循：? 應使用標準的或常用的簡寫，如 Temp（tmp），Length（len）；? 應用范圍內(nèi)簡寫應一致且規(guī)范，避免各 處簡寫各不相同；? 簡寫可以使用單詞的前一個或多個字母，如 Channel（Chan）、Connect（Conn）；也可以使用去掉所有的不在詞頭的元音字母，如 screen（scrn），primtive（prmv）；? 多個單詞組成的名稱，使用有意 義的單詞或去掉無用的后 綴并簡稱，如 Count of Failure（FailCnt），Paging Request（PagReq）。 （應用使用的外部庫及頭文件放置在 rel 同級的 lib 與lib/include 目錄）規(guī)則 6: 各子系統(tǒng)可以創(chuàng)建獨立的編譯文件并放置到 src/module/source 目錄，編譯后的可執(zhí)行文件放置到 rel/bin/module 目錄或 rel/bin，靜態(tài)庫或動態(tài)庫放置到 rel/lib/module 或 rel/lib 目錄。 ii++){ if(!IsChineseChar(sInStr + ii)) { return FALSE。例：BOOL IsChineseString(const char* sInStr)。規(guī)則 2: 一個模塊可以包含一個類或功能上緊密聯(lián)系的多個類。本 規(guī)范分 C/C++編碼規(guī)范、Java 編碼規(guī)范、 PB 編碼規(guī)范三篇，分別從代碼組織、命名、注釋、編碼風格、 編譯等方面加以闡述。然而應用軟件設計是一項團結(jié)協(xié)作工程，而非程序員展示個人 藝術(shù)的舞臺，大型 應用 軟件項目更是由很多程序員組成的大型開發(fā)團隊協(xié)同完成的。每個程序 員都有自己的編碼經(jīng)驗 與風格，如果缺乏 統(tǒng)一的編程規(guī)范，則可能導致軟件產(chǎn)品最終程序代碼風格迥異，可 讀性與可維護 性均較差，不 僅給程序代碼的理解帶來障礙，也增加維護階段的工作量。規(guī)范文本分為規(guī)則與建議兩種，其中規(guī)則是強制執(zhí) 行的條款，建 議則由程序員根據(jù) 實際情況靈活掌握。禁止將功能關聯(lián)松散的多個類，放置到一個模塊中。例：static BOOL IsChineseChar(const char* s){ ……。 }}return TRUE。此時，應創(chuàng)建一個編譯全部子系統(tǒng)的編譯文件或腳本放置到 src 目錄。 文件命名規(guī)則 9: 文件命名應使用模塊名的小寫字母形式。常用前綴符前綴符 含義 例子g_ 全局變量 g_stSystem, g_cMacType， g_strSysNames_ 靜態(tài)變量 s_nCurCnt，s_strStaticName，s_pSysTimem_ 類數(shù)據(jù)成員 m_nBankType，m_sWrkBuffer, m_strMyNameh 句柄類變量 hnFileHandle，hnSocket，hpProcHandlep 指針類變量 psReadBuff，pstrRetStr，ppTargeta 數(shù)組類變量 anPorts，asSendBuffers，apWrkBuffs常用基本類型符前綴符 含義 例子b bool bOK，bQuit，bFindc、ch char cFlag，cBankType，chSubSystemTypes char [] sSysName，sStaticName，sTimeStrstr CString、String strSysName, strStaticName, strTimeStrby unsign char [] byMacStr，bySendBuffer, bySrcBuffern、i int nCnt，nPort，nRetCodel long lFileSize，lOffset，lCountd double dAmount，dSumVal，dWrkValf float fAmount, fSumVal, fWrkValui/ul unsigned int/long uiCnt, uiFileSize, ulRetCountw WORD 與 unsigned int 等價的 32 位整數(shù) dw DOUBLE WORD 與 unsigned long 等價的 64 位整數(shù)em 枚舉型變量 emDays, emColors, emSetst 結(jié)構(gòu)型編碼 stSystem，stCtrlData, stSet規(guī)則 11: 禁止使用單字母作為變量名。如：ifndef __CSIGNAL_HPP__define __CSIGNAL_HPP__…endififndef __CSIGNAL_H__define __CSIGNAL_H__…endif 類命名規(guī)則 16: 類命名應使用字符 C|T＋名稱形式。如：GetName()，StrTrimLeft()， KillProc()。 參數(shù)命名建議 2: 函數(shù)或方法的參數(shù)命名參考變量命名，但 應使用 In，Out、Ret 等簡寫修飾參數(shù)，增加函數(shù)聲明的可讀性。 文檔化注釋 文件注釋規(guī)則 19: 文件注釋放置在文件頭部，主要包括此文件的功能說明， 編寫人和修改人以及編寫和修改的日期，版權(quán)聲明，版本等信息，應盡量使用中文。** par 版權(quán)信息：* Copyright(C) 20222022 CNCC/CDC*/注：粗體字為需定制化的內(nèi)容；蘭色字為可選的內(nèi)容，如果沒有這些內(nèi)容， 請刪除。br * 本類主要提供下列三類方法： * 信號集合管理，提供信號集合的添加、刪除、判斷功能； * 信號句柄管理，提供設置與獲取信號處理函數(shù)功能； * 信號處理，設置與獲取阻塞信號集、發(fā)送信號、等待信號功能。 * return 返回 值說明 * 返回值 1 返回值 1 說明； * 返回值 2 返回值 2 說明。 * warning 警告信息* deprecated 函數(shù)即將失效警告* see 引用說 明 * * par 使用范例 : * code * 例子程序 * endcode ** par 算法或流程 說明:* 詳細算法或流程說明* * par 變更歷 史： *