從一段舊代碼想到的

 

今天一個偶然的機會開啟了自己以前寫的舊程式，時間大概是上世紀90年代後期（96-99年左右），代碼是用C語言寫的，運行在Windows 3.1或Windows 95環境下。看到它們，有一種看上學時照片的感覺，感覺是那麼的青澀。拿出一段晒晒：

 

//-----------------------------------------------------------------------------
// 函數：NewPoint
// 功能：分配一個測點定義緩衝區。
// 入口參數：
//    lpPNum    測點號指標。
// 出口參數：
//    如成功，返回在測點定義表中的位移；如失敗，返回0xffff。
//-----------------------------------------------------------------------------
WORD NewPoint(LPCSTR lpPNum)
{
    WORD i;
    LPTPOINT lpTmpPt;

    // 在測點定義表中找空的緩衝區
    for (i=0;i<PtTab.wCount;i++) if (PtTab.lpPt[i].tpDel) break;
    if (i==PtTab.wCount) {
        // 如未找到，則判斷測點數是否已到最大值，如已到，則返回失敗
        if (PtTab.wCount+1>MAXPOINT) return(0xffff);
        // 如未找到最大值，則測點總數加1。即在測點定義表的最後追加一個緩衝區
        PtTab.wCount++;
    }
    // 初始化緩衝區
    lpTmpPt=&PtTab.lpPt[i];
    // 將刪除標誌(即緩衝區空標誌)置1，作為後面具體定義時區分增加與修改的標誌，
    // 如是修改，則此標誌必為0
    lpTmpPt->tpDel=1;
    // 拷貝測點號到緩衝區
    lstrcpy(lpTmpPt->tpNum,lpPNum);
    // 將前一此操作測點的定義複製到緩衝區
    lstrcpy(lpTmpPt->tpName,HistPt.tpName);
    lpTmpPt->tpType=HistPt.tpType;
    lpTmpPt->tpOp=HistPt.tpOp;
    // 賦預設的狀態與數值
    lpTmpPt->tpState=PS_SUSP;
    lpTmpPt->tpRValue=0;
    lpTmpPt->tpDValue=0;
    // 置預設的狀態變化時間為目前時間
    _fmemcpy(&lpTmpPt->tpTime,&Time,sizeof(SYSTIME));
    // 將位移值返回
    return(i);
}

 

這是當年開發的一個煤炭安全監視軟體裡增加新測點的函數。如果在當年看這段代碼，感覺這應該是一段挺不錯的代碼，比如：注釋很多，幾乎每行都有注釋；匈牙利命名法，使用像lp、w這樣的首碼；結構、數組、宏定義，看起來都是有板有眼。

 

時間已經過去十幾年了，電腦系統、開發語言、設計思想都有了很大轉變，現在要寫一段同樣功能的代碼，可能完全不同了。

 

最大的變化應該是物件導向技術的應用，測點和測點表都會從struct變為class，測點數組可能會用std::vector或std::list代替，並且用new來動態分配，宏定義也會換成常量或枚舉。而上面這個建立新測點的函數，也會被封裝到測點表這個類中。物件導向技術改變了我們思考和實踐的方式，而且這個改變作用是巨大的。

 

再有就是一些設計思想的轉變，比如對注釋的看法。以前，注釋多可能意味著可讀性強。但《重構》一書中說：“你看到一段代碼有著長長的注釋，然後發現，這些注釋之所以存在乃是因為代碼很糟糕。”再看看上面這段代碼，前半段，其實是尋找一個空的測點位置，完全可以用Extract Method（提煉函數）重構方法將其移入另外一個函數，並給其一個準確的命名，而不需要注釋。後半段，“代碼已經清楚說明了一切，注釋已經變得多餘了。”

 

匈牙利命名法，已成為爭議最大的命名法，其類型冗餘常常大於它所帶來的收益。它來自微軟的一名匈牙利程式員，但現在微軟的.Net和它的程式設計語言中，微軟更換了這一法則，在C#中以駱駝命名法和帕斯卡命名法居多。

 

電腦系統的提升也改變著程式。早年16位OS上編程需要區分遠指標和近指標，但現在32位環境下，C++指標變數首碼一般都是p，很少見到lp。

 

技術在進步，編程思想在轉變，人的思維也在不斷更新。也許再過十幾年，現在聽都沒有聽說過的新技術會大行其道，你回頭再看看現在的代碼，可能也會有像我今天的感覺。但無論怎樣，請不要輕視我們的過去，因為沒有過去的積累，就沒有今天的進步。