• <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>
    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>
            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>

            牽著老婆滿街逛

            嚴以律己,寬以待人. 三思而后行.
            GMail/GTalk: yanglinbo#google.com;
            MSN/Email: tx7do#yahoo.com.cn;
            QQ: 3 0 3 3 9 6 9 2 0 .

            C/C++源代碼書寫規范

            1. 在.h/.cpp的開頭應有一段格式統一的說明,內容包括:
            a. 文件名 (FileName);
            b. 創建人 (Creator);
            c. 文件創建時間 (Date);
            d. 簡短說明文件功能、用途 (Comment)。
            例:
            //////////////////////////////////////////?
            //?
            //?FileName:?GetVersion.h?
            //?Creator:?Liu?Haifeng?
            //?Date:?2002-10-28?
            //?Comment:?Get?file?version?information?
            //?
            //////////////////////////////////////////?

            2.對于主要功能函數應有注釋說明。內容包括:功能、入口/出口參數,必要時還可有備注或補充說明,對于函數中的主要功能代碼,也應有注釋說明。注釋以英文為主。
            例:
            //////////////////////////////////////////?
            //?
            //Remarks:?
            //?Check?file?whether?exist?
            //?
            //Parameters:?
            //?LPCTSTR?lpszPathName?:?Input?full?path?name?
            //?
            //Return?values:?
            //?int?:?Non-zero?means?success?
            //?Zero?means?failure?
            //?
            //////////////////////////////////////////?

            3. 每列代碼的長度推薦為80列,最長不得超過120列;折行以對齊為準。
            例:HANDLE KSOpenFile(const char cszFileName[],
            int nMode);
            或者:
            BOOL?KSReadFile(?
            HANDLE?hFile,?
            void?*pvBuffer,?
            int?nReadSize,?
            int?*pnReadSize?
            );?

            4. 循環、分支代碼,判斷條件與執行代碼不得在同一行上。
            例:正確:
            if (n == -2)
            n = 1;
            else
            n = 2;
            不得寫做:
            if (n == -2) n = 1;
            else n = 2;
            5. 指針的定義,* 號既可以緊接類型,也可以在變量名之前。
            例:可寫做:int* pnsize;
            也可寫做:int *pnsize;
            但不得寫做:int * pnsize;
            6. 在類的成員函數內調用非成員函數時,在非成員函數名前必須加上"::"。
            例:::Sleep(2000);
            7. 函數入口參數有缺省值時,應注釋說明。
            例:
            BOOL KSSaveToFile(
            const char cszFileName[],
            BOOL bCanReplace /* = TRUE */
            );
            或者:
            BOOL KSSaveToFile(
            const char cszFileName[],
            BOOL bCanReplace // = TRUE
            );
            8. else if 必須寫在一行。
            9. 與‘{’、‘}’有關的各項規定:
            9.1‘{’、‘}’應獨占一行。在該行內可有注釋。
            例:正確:
            for (i = 0; i < cbLine; i++)
            { // .....
            printf("Line %d:", i);
            printf("%s\n", pFileLines);
            }
            不得寫做:
            for?(i?=?0;?i?<?cb;?i++)?
            {?printf("Line?%d:",?i);?
            printf(
            "%s\n",?pFileLines);?
            }
            ?

            9.2‘{’必須另起一行,‘{’之后的代碼必須縮進一個Tab。‘{’與‘}’必須在同一列上。
            例:正確:
            if (i > 0)
            {
            m = 1;
            n++;
            }
            不得寫做:
            if?(i?>?0)?{?
            m?
            =?1;?
            n
            ++;?
            }
            ?

            例外:
            if?(i?==?0)?
            {?ASSERT(FALSE);?return;?}?

            9.3 在循環、分支之后若只有一行代碼,雖然可省略‘{’、‘}’,但不推薦這么做。若省略后可能引起歧義,則必須加上‘{’、‘}’。
            例:正確:
            if?(n?==?-2)?
            n?
            =?1;?
            else?
            n?
            =?2;?

            或者:
            if?(n?==?-2)?
            {?n?=?1;?}?
            else?if?(n?!=?nTemp)?
            {?n?=?2;?}?
            else?
            {?n?=?3;?}?

            不得寫做:
            if?(n?==?-2)?
            n?
            =?1;?
            else?if?(n?!=?nTemp)?
            n?
            =?2;?
            else?
            n?
            =?3;?

            不推薦:
            if?(i?<?1)?
            {?n?=?1;?}?
            else?
            {?
            if?(i?==?1)?
            {?n?=?2;?}?
            else?
            {?
            if?(i?>?1)?
            {?n?=?3;?}?
            }
            ?
            }
            ?

            10. 與空格有關的各項規定。
            10.1 在所有兩目、三目運算符的兩邊都必須有空格。在單目運算符兩端不必空格。但在‘->’、‘::’、‘.’、‘[’、‘]’等運算符前后,及‘&’(取地址)、‘*’(取值)等運算符之后不得有空格。
            例:正確:
            int n = 0, nTemp;
            for (int i = nMinLine; i <= nMaxLine; i++)
            不得寫做:
            int n=0, nTemp;
            for ( int i=nMinLine; i<=nMaxLine; i++ )
            10.2 for、while、if 等關鍵詞之后應有1個空格,再接‘(’,之后無空格;在結尾的‘)’前不得有空格。
            例:正確:
            if (-2 == n)
            不得寫做:
            if(-2 == n)

            if ( -2 == n )
            等等。
            10.3 調用函數、宏時,‘(’、‘)’前后不得有空格。
            例:正確:
            printf("%d\n", nIndex);
            不得寫做:
            printf ("%d\n", nIndex);
            printf( "%d\n", nIndex );
            等等。
            10.4 類型強制轉換時,‘(’‘)’前后不得有空格
            例:可寫做:
            (KSFile*)pFile;
            也可寫做:
            (KSFile *)pFile
            不得寫做:
            ( KSFile* )pFile
            ( KSFile * ) pFile
            11. 與縮進有關的各項規定
            11.1 縮進以 Tab 為單位。1 個 Tab 為 4 個空格
            11.2 下列情況,代碼縮進一個 Tab:
            1. 函數體相對函數名及'{'、'}'。
            例:
            int?Power(int?x)?
            {?
            return?(x?*?x);?
            }
            ?

            2. if、else、for、while、do 等之后的代碼。
            3. 一行之內寫不下,折行之后的代碼,應在合理的位置進行折行。若有 + - * / 等運算符,則運算符應在上一行末尾,而不應在下一行的行首。
            11.3 下列情況,不必縮進:switch 之后的 case、default。
            例:
            switch?(nID)?
            {?
            case?ID_PLAY:?
            ?
            break;?
            case?ID_STOP:?
            ?
            break;?
            default:?
            ?
            break;?

            12.對于涉及到系統的功能調用,要求使用系統提供的宏,不得直接使用具體的數值。
            例: char szSystemPath[MAX_PATH] = {0}; 正確
            char szSystemPath[260] = {0}; 錯誤
            13.關于函數編寫的規定
            13.1 除了非常簡單的函數或者沒有必要,函數需要有返回值,并且推薦
            返回值的類型為int,成功時為 true,失敗時為false。不推薦直接使用1和0來表示。
            13.2 在函數內部變量定義全部放在函數的開始處,不能在代碼中間出現 變量定義。變量定義需要初始化值,一般是0、false、NULL等。
            13.3 程序員自行編寫的函數不推薦使用DWORD等指明字節長度的變量 類型,推薦使用unsigned long等變量類型。對于ULONG等vc系統定義的變量類型,推薦使用unsigned long 來代替。如果調用系統API,在MSDN中已經指明了是DWORD等類型,則可以使用。
            13.4 推薦使用int nResult作為函數自身的返回值變量,int nRetCode、BOOL bRetCode作為調用其他函數的返回值變量。
            13.5 推薦使用goto語句來統一函數出口,goto語句一般只能跳轉到一個函數出口,最多只能有兩個,出口標識必須命名為Exit0和Exit1。在出口處必須顯式檢查曾經申請過的系統資源(如內存),并且進行釋放。
            13.6 如果編寫DLL,除非特殊情況,導出函數的調用類型必須是__stdcall,便于多模塊協同工作。

            附錄:
            1.函數編寫示范
            /////////////////////////////////////////////////////////////////////?
            //?
            //?Remarks:?
            //?Get?file?version?information?
            //?
            //?Parameters:?
            //?[in]?const?char?cszPathName?:?Input?file?path?name?
            //?[out]?PVERSION_INFO?*pVersionInfo?:?File?version?information?
            //?
            //?Return?values:?
            //?int?:?Non-zero?means?success,?zero?means?failure?
            //?
            /////////////////////////////////////////////////////////////////////?
            int?GetFileVersion(const?char?cszPathName,?PVERSION_INFO?*pVersionInfo)?
            {?
            int?nResult?=?false;?
            int?nRetCode?=?false;?
            char?szSystemPath[MAX_PATH]?=?{0};?
            nRetCode?
            =?IsFileExist(cszPathname);?
            if?(!nRetCode)?
            goto?Exit0;?
            //Others?code?here?
            nResult?=?true;?
            Exit0:?
            return?nResult;?
            }

            posted on 2006-04-21 18:01 楊粼波 閱讀(611) 評論(0)  編輯 收藏 引用 所屬分類: 文章收藏

            久久久噜噜噜久久中文字幕色伊伊| 91久久精品电影| 青青草原综合久久大伊人| 亚洲中文字幕久久精品无码APP| 亚洲精品国产字幕久久不卡| 久久不射电影网| 亚洲伊人久久成综合人影院| 精品熟女少妇a∨免费久久| 久久国产福利免费| 久久久久人妻精品一区| 青青青青久久精品国产h久久精品五福影院1421 | 7777久久久国产精品消防器材| 99久久免费国产精品热| 一本一道久久a久久精品综合 | 久久99亚洲综合精品首页| 精品熟女少妇AV免费久久| 国产精品成人99久久久久| 亚洲AV日韩精品久久久久久| 久久久青草青青国产亚洲免观| 久久精品人人槡人妻人人玩AV | 亚洲国产另类久久久精品小说| 久久国产成人| 久久91亚洲人成电影网站| 亚洲中文字幕久久精品无码APP| 香蕉久久AⅤ一区二区三区| 久久r热这里有精品视频| 99久久精品日本一区二区免费| 乱亲女H秽乱长久久久| 久久精品国产久精国产一老狼| 香港aa三级久久三级老师2021国产三级精品三级在 | 狠狠久久亚洲欧美专区| 日韩人妻无码一区二区三区久久| 亚洲精品综合久久| 久久强奷乱码老熟女| 久久av高潮av无码av喷吹| 国产69精品久久久久99尤物| 久久成人影院精品777| 精品久久777| 久久精品国内一区二区三区| 精品国产福利久久久| 欧美伊香蕉久久综合类网站|