【正文】 說明 2。 * param [out] stSet 要操作的信號集合； * param [in] nSignal 要添加到集合的信號； * param [in] nOtherSignal 要添加到集合的其他信號。 * note 如果要添加多個信號，則必須使用 0 作為最后一個信號。stSet, SIGUSR1, SIGUSR2, 0)。stSet, SIGHUP)。建議 3: 重要的或復(fù)雜的函數(shù)， 應(yīng)提供算法說明或使用范例。 * param [in] sBankCode 行號； * param [in] sPassword 密 碼。 * par 算法介 紹： * 計算 sBankCode + sPassword 的 MD5 數(shù)字摘要，輸出 32 位字符； * 取 32 位字符的 0，5，10，15，16，21，26，31 位作 16 位字符串的偶數(shù)位； * 取AUTHBEPS各位作 16 位字符串的奇數(shù)位； * 加密這 16 位的字符串，得到 32 位的字符串作為認(rèn)證串。 數(shù)據(jù)成員注釋規(guī)則 22: 類的每個數(shù)據(jù)成員均使用斷行注釋。 /// 是文件型報文？ CString m_strFileName。 /// 直接設(shè)置的報體串 CMTMsgHeader m_Header。 /// 報尾對象 CMTBatHeader m_BatHeader。注釋格式如下：例：/** 報頭結(jié)構(gòu)，總長度 138 字節(jié)。 /// 報頭塊前綴 = {1:。 /// 版本號，保留 = 0。 /// 報文總長度，保留，目前為空白。 /// 業(yè)務(wù)碼 0 位(系統(tǒng)號) 13 位 CMT 號 4 位 節(jié)點 57 位 保留。 /// 報文源地址，即報文發(fā)起人。 /// 報文目標(biāo)地址，即報文接收人。 /// 報文用途，保留。 /// 輸出標(biāo)識，保留。 /// 報文標(biāo)識號，報文發(fā)起人生成，通信層唯一確定一個報文。 /// 報文參考號，報文發(fā)起人生成，回應(yīng)報文帶回進(jìn)行報文匹配。 /// 報文日期，格式為 YYYYMMDD。 /// 報文時間，格式為 YYYYMMDDHHMISS。 /// 報文有效期，保留， 00xFFFF=65535。 /// 報文提交時間，保留，格式為 HHMISS。 /// 報文優(yōu)先級， 0x00xF=15。 /// 保留域。 /// 報頭塊后綴 = }。 宏與變量注釋規(guī)則 24: 宏與變量使用簡單注釋或斷行注釋。 注釋格式如下：例：define MBT_PREFIX { /// 報文塊開始標(biāo)志define MBT_SUFFIX } /// 報 文塊結(jié)束標(biāo)志define MBT_HEADER {1: /// 報頭塊開始標(biāo)志define MBT_BUSINESSHEADER {2: /// 業(yè)務(wù)頭塊開始標(biāo)志define MBT_BUSINESSDATA {3: /// 正文塊開始標(biāo)志define MBT_TAIL {C: /// 報尾塊開始標(biāo)志define MBT_FILE {F: /// 文件說明塊開始標(biāo)志define MBT_BATHEADER {B: /// 批量信息塊開始標(biāo)志define TAG_PREFIX : /// TAG 名開始標(biāo)志define TAG_SUFFIX : /// TAG 名結(jié)束標(biāo)志define MSGID_LEN 20 /// 報文標(biāo)識號長度(MSGID)define REQUESTID_LEN 20 /// 報文參考號長度(REQID)例：/** 業(yè)務(wù)頭保留域長度 */define CMTBH_RESERVED_LEN 16例：/** * brief 短報文正文體最大 長 度。 * * par 計算公式： * code * 最大 長度 = MQCMT 消息長度 sizeof(CMTMsgHeader) sizeof(CMTMsgTail) sizeof(MQMsg) +1 * = MQCMT 最大消息長度 175 * endcode * 目前，MQCMT 類定義的最大消息 長度為 1M=1048576 字節(jié)。如：/** * …* par CMT 報 文格式說明： * CMT 報文由報頭( CMTMsgHeader )、可選的批量業(yè)務(wù)頭( CMTBatHeader )、正文體、報尾( CMTMsgTail )組成。每個業(yè)務(wù)塊由一個定長的業(yè)務(wù)頭( CMTBusinessHeader )與一個變長正文塊( CMTBusinessData ) 組成； * 正文塊( CMTBusinessData )由一個或多個 TAG 碼:TAG 值對(報文域)組成，部分TAG 值 又可由多個定 長子域 組成； * 正文體可放置在報 文中，也可存儲在文件中，而在報文中僅放置文件名； * 當(dāng)正文體在文件中，則說明批量業(yè)務(wù)頭、 業(yè)務(wù)頭、正文塊存儲在文件中。如果需要段首縮進(jìn)兩字符，使用全角的空格。如：/** * … * * par 算法原理： * 計算機(jī)內(nèi)部運算使用的基數(shù)是 2，即滿 2 進(jìn)位。 * 根據(jù)此原理，本類使用 65536 作為基數(shù)，每個整數(shù)的最大位數(shù) 10(unsigned int array [10])， * 因此可以最大整數(shù)是 65536 的 10 次方，約 。*/? 需要生成圓點列表時使用－，需要生成 編號列表時使用－ 。如：* par 計算公式： * code * 最大 長度 = MQCMT 消息長度 sizeof(CMTMsgHeader) sizeof(CMTMsgTail) sizeof(MQMsg) +1 * = MQCMT 最大消息長度 175 * endcode? 為使 doxygen 正確生成函數(shù)或方法的連接，注釋中的函數(shù)名或方法名前后應(yīng)留一個空格。如該函數(shù)或方法重載，則應(yīng)必須使用參數(shù)（類型）列表，如 GetTag(LPCSTR, AMOUNTamp。 語句塊注釋規(guī)則 25: 程序代碼主要流程、重要算法以及 邏輯性較強(qiáng) 的代碼和有特殊設(shè)計意圖的代碼（如沒有 break 的 case 塊、空循環(huán)體、空 語句塊）等位置， 應(yīng)添加 語句塊注釋。規(guī)則 26: 語句塊注釋應(yīng)遵循下列原則：? 應(yīng)使用斷行注釋，即//；? 一目了然的語句不應(yīng)注釋；? 每個分支、每個功能段均 應(yīng)注釋；? 應(yīng)放置在緊臨該語句塊上方或語句右側(cè)，與其上方的語句塊應(yīng)留一空行，禁止放置在語句塊的下方，但可以在語句 塊下方放置該語句塊結(jié)束的注 釋。例：主要流程注釋// 參數(shù)檢查 if(nInpLen == 0 || byInpData == NULL){ // 檢查失敗()。} // 清除行計數(shù) static int nLineChars = 0。 } // 計算輸出長度 int nOutLen = 2*4*(nInpLen/3 +1)。 memset(p, 0, nOutLen)。 // MD5 指紋 CString strMD5 = ((BYTE*)(0), ())。 char sTmpStr[17]。 memset(sTmpStr, 0, sizeof(sTmpStr))。 ii8。 // p = AUTHBEPS。 ii8。例：特殊設(shè)計意圖BigInt::~BigInt(){ // NOTHING}switch(atoi()){ case 1: // 已付款 exec sql update CISCODT0702 set PAYCNT = : where WORKDATE = : and CLSCODE = : and RSTYPE = : and ARSTSIGN = : and CGTYPE = :。 break。 CheckDBError(CISCODT0702, E_DB_UPDATE)。 default: // DO NOTHING break。如：例：ifdef 0// 直接解析批量包報文（一次讀取一個塊）int CMTFileOperator::ParseMessage(CMTPkgMsg amp。 CString strWrkStr。 while(1) { ReadBlock(strWrkStr, bNoDetail)。 // 正文塊檢查 if( bMustData amp。 strncmp(strWrkStr,MBT_BUSINESSDATA,strlen(MBT_BUSINESSDATA))!=0) { THROW_OUT(E_NEEDBUSIDATA, )。 // 其他報文塊 // 目前沒有這樣的塊，做錯塊 CString s。 THROW_OUT(E_UNKNOWBLOCK, s)。 * (() strlen(MBT_FILE) strlen(MBT_SUFFIX))。 * // 自動解析文件 * ClearFailStatus()。 * ExitOnFail()。}endif 代碼維護(hù)注釋規(guī)則 27: 維護(hù)已經(jīng)定版的代碼時，禁止直接 刪除或編輯 舊代碼，而 應(yīng)使用注釋保留舊代碼，然后在舊代碼下方增加新修改后的代碼。對代碼塊進(jìn)行修改的，還應(yīng)標(biāo)明修改結(jié)束的位置。例：注銷舊代碼// 20220413 lny delete: 將此函數(shù)遷移到 文件。 if (lpErrText!=NULL) s = lpErrText。 ThrowException(iCode, s)。 // 解讀報文塊// 20220902 lny modify: 增加自動讀取報體文件功能。 if (IsEmptyStr(pMsg)) return 0。 int nRetCode = Patch(pMsg)。 if (m_bBodyInFile amp。 bAutoReadBodyFile) { // Auto read the body file. CBuffedFile reader。 (打開報文體文件[%s]失敗!, (0))。 } … }return 0。應(yīng)用程序全部代碼應(yīng)保持一致，要么使用 TAB，要么使用四個空格，不應(yīng)混用。例：if (!IsQuit()) { exit(0)。}建議 7: 每行只定義一個變量或包含一個語句。應(yīng)書寫為：int nRetCode。規(guī)則 31: 超長的語句（80 字符）或表達(dá)式應(yīng)分成多行書寫。劃分出的新行要進(jìn)行適當(dāng)?shù)目s進(jìn)，使排版整齊，語句易讀。應(yīng)書寫為：THROW_OUT(E_INVALIDLIST, StrPrint(票交機(jī)構(gòu)行別非數(shù)字或長度非 3 位! [%s],).GetBuffer(0))。例： = 0。 = 300。應(yīng)書寫為： = 0。 = 300。建議 9: 定義多個宏或初始化多個變量時，將 值對齊。m_bDoConnect = FALSE。應(yīng)書寫為：m_bIsConnected = FALSE。MQOD od = { MQOD_DEFAULT }。例：if (!IsQuit()) exit(0)。}建議 11: 定義指針或引用時，*與amp。例：int *p = amp。CString amp。應(yīng)書寫為： int* p = amp。CStringamp。 空格與空行規(guī)則 32: 相鄰兩個功能相對獨立的代碼塊間應(yīng)使用空行隔開。 memcpy(amp。md, sizeof(md))。 MQPMO pmo = { MQPMO_DEFAULT }。m_pmo, amp。 = MQOD_VERSION_2。 memcpy(amp。gmo, sizeof(gmo))。應(yīng)書寫為： MQMD md = { MQMD_DEFAULT }