程式師世界 >> 編程語言 >> C語言 >> C++ >> 關於C++ >> 成為C++高手之提高可維護性

成為C++高手之提高可維護性

編輯：關於C++

思路

當前的Poker工程還能進一步改進：把只與撲克相關的各種聲明和定義單獨拿出來，放到單獨的文件中；把只與玩家相關的東西拿出來，放到單獨的文件中，而main函數裡只是使用這些定義或聲明，於是變成了三個文件：poker.c、player.c,main.c。這樣帶來什麼好處呢？一是要查看或修改poker相關的功能，我們只需打開poker.c。現在由於程序小，感覺不出分開的優勢，但當寫一個程序要處理幾十上百種結構時，如果不分開，面對一個上萬行代碼的main文件，相信一般人都會頭暈。二是當別人要寫一個poker游戲時，發現我們的poker.c中已經把操作一副牌的功能都實現了，於是他們只需把poker.c文件復制到自己的工程中用就OK了。通過分散到多個文件中，我們提高了代碼的可維護性和可重用性。

下面我們就來研究一下代碼中的東西該歸各處：

Card結構，表示一張牌，肯定要放到poker.c中。定義一副牌數量的宏CARD_COUNT只與撲克有關，放到poker.c中。定義poker花色的枚舉，與宏CARD_COUNT一樣，放到poker.c中。比較函數，只與撲克相關，放到poker.c中。比較函數類型定義，跟著比較函數走，放到poker.c中。構造一副牌的函數initOnePack，放到poker.c中。洗牌函數shuffle，只操作Card結構，放到poker.c中。排序函數，只排撲克的序，放到poker.c中。獲取牌名字的函數，只操作撲克，放到poker.c中。結構Player，肯定放到player.c中。存放原始一副牌的數組pokers，放到poker.c中。分牌函數，操做了Player和Card兩個結構，放在main.c中可以，是從人思維角度講，是人發牌，所以把它放到 player.c中也沒問題。這個隨意吧，但是我個人的話感覺放到player.c文件中比較好，所以我放到player.c中。函數聲明們跟著函數定義走。

現在是不是可以在main.c裡include這兩個文件然後就能編譯出結果呢?有個問題先說明一下：c文件也是可以被include的，因為include的實質就是將被include的文件的內容復制到include行的位置。但include之後會產生一大堆錯誤，編譯是不會成功的。這些錯誤的描述大都是說類型或標志符重復定義。這些錯誤是怎麼造成的，後面再說，先說怎麼解決。解決方法很簡單：將poker.c和player.c從編譯中排除，即不再編譯poker.c和player.c。它們的內容會被插入main.c中，形成完整的main.c，此時poker.c和player.c不需要編譯了。如果編譯的話，就會產生重復定義，其原因後面的“編譯過程詳解”（請期待）一節有解釋。所以要把這兩個文件從工程中刪掉，但不能刪除實際的文件哦，只是從工程中刪除對它們的引用，如果刪掉了實際的文件，include就是找不到文件了。

刪除一個文件的引用，在QTCreator中是這樣的，如圖，不要選中check按鈕：

這裡寫圖片描述

現在三個文件是這樣的：

poker.c

#include 
//一副牌的數量
#define CARD_COUNT 54
//定義撲克的花色
enum Suit{
    heart,
    spade,
    diamond,
    club,
    joker1,
    joker2
};
//定義撲克
typedef struct Card{
    int value;//牌的點數從1開始
    enum Suit suit;//花色
}Card;
//定義比較函數的類型
typedef int (*COMPARE)(Card* ,Card*);
//原始一副牌所在的數組
Card pokers[CARD_COUNT];
//構造一副牌
void initOnePack(){
    int i=0;
    //前52張
    for(;ivalue > b->value){
        return 1;
    }else if(a->value < b->value){
        return 0;
    }else{
        if(a->suit > b->suit)
            return 1;
        else
            return 0;
    }
}
//比較函數，先比較點數再比較花色
int compare2(Card* a,Card* b){
    if(a->value > b->value){
        return 0;
    }else if(a->value < b->value){
        return 1;
    }else{
        if(a->suit > b->suit)
            return 0;
        else
            return 1;
    }
}
//獲取牌的名字
//返回牌的名字字符串，調用者用完後需要free()之。
char* getCardName(const Card* card){
    //存放花色名字
    char suitStr[16]={0};//0=='\0'
    switch (card->suit) {
    case heart:
        strcpy(suitStr,"紅桃");
        break;
    case spade:
        strcpy(suitStr,"黑桃");
        break;
    case diamond:
        strcpy(suitStr,"方塊");
        break;
    case club:
        strcpy(suitStr,"梅花");
        break;
    }
    //存放點數名字
    char valueStr[16];
    switch(card->value){
    case 1:
        strcpy(valueStr,"A");
        break;
    case 11:
        strcpy(valueStr,"J");
        break;
    case 12:
        strcpy(valueStr,"Q");
        break;
    case 13:
        strcpy(valueStr,"K");
        break;
    case 14:
        strcpy(valueStr,"小王");
        break;
    case 15:
        strcpy(valueStr,"大王");
        break;
    default:
        sprintf(valueStr,"%d",card->value);
        break;
    }
    //動態分配足夠的空間
    char * ret = malloc(16);
    //將兩個名字合並到ret中
    sprintf(ret,"%s%s",suitStr,valueStr);
    return ret;
}

player.c:

//定義玩家
typedef struct Player{
    char name[64];//玩家的名字
    Card ** cards;//玩家分到的牌。每項是一個指針，指向原始一副牌數組中的一項，這樣可以節省空間
    int cardsCount;//玩家分到的牌的數量
}Player;
//發牌
//players是玩家數組
//playerCount是玩家數量
//shuffledCards是洗完後的一副牌
void dispatchCards(Player** players,int playerCount,const Card** shuffledCards){
    //計算每個玩家手中牌的數組的容量，如果每個玩家手中的牌不一樣，
    //最多就差一張，加1是為了保證數組分配的空間足夠容納分到的牌。
    int numberCards = CARD_COUNT/playerCount+1;
    //為每個玩家的牌數組分配空間
    int i;
    for(i=0;icards = cards;
    }
    //輪流向每個玩家發牌
    for(i=0;icards[curPlayer->cardsCount] = shuffledCards[i];
        //玩家手中實際的牌數增加
        curPlayer->cardsCount++;
    }
}

main.c:

#include 
#include 
#include 
#include "poker.c"
#include "player.c"
//函數聲明們
//char* getCardName(const Card*);
//Card** shuffle(const Card*);
//void dispatchCards(Player** ,int ,const Card** );
//void sort(Card**,int,COMPARE);
//int compare1(Card* ,Card*);
//int compare2(Card* ,Card*);
//void initOnePack();
//原始一副牌所在的數組
Card pokers[CARD_COUNT];
//入口函數
int main(void)
{
    //初始化一副牌
    initOnePack();
    //洗牌，shuffledPokers保存洗後的牌們
    Card** shuffledPokers = shuffle(pokers);
    //構建三個玩家
    Player player1;
    strcpy(player1.name,"隔壁老王");
    player1.cards=NULL;
    player1.cardsCount=0;
    Player player2;
    strcpy(player2.name,"小明");
    player2.cards=NULL;
    player2.cardsCount=0;
    Player player3;
    strcpy(player3.name,"田中龜孫");
    player3.cards=NULL;
    player3.cardsCount=0;
    //把三放到一個數組中，以傳入發牌函數中
    Player* players[]={&player1,&player2,&player3};
    //發牌
    dispatchCards(players,sizeof(players)/sizeof(Player*),shuffledPokers);
    //洗後的牌用完了，釋放之
    free(shuffledPokers);
    int i;
    //打印出每個玩家手中的牌
    for(i=0;iname);
        //需要對玩家手中的牌排序
        sort(players[i]->cards,players[i]->cardsCount,compare1);
        //打印玩家手中所有的牌
        int j;
        for(j=0;jcardsCount;j++){
            char * name = getCardName(players[i]->cards[j]);
            printf("%s ",name);
            free(name);
        }
        //每個玩家都需要換一次行
        printf("\n");
    }
    //釋放玩家手中牌的數組
    for(i=0;icards);
    }
    return 0;
}