筆記 - GNU Coding Style - My code works, I don’t know why.

這是沒事亂看的，主要找和C 語言相關的描述，就不要在意文章組織和可讀性了。

閱讀版本：July 25, 2016

CH 3

原本程式碼

#ifdef HAS_FOO
...
#else
...
#endif

建議使用方式

if (HAS_FOO)
...
else
...

使用動態配置資料方式避免資料長度限制，包含檔案名稱長度、一行長度等
讀檔案時不得丟棄NUL字元以及不可列印字元，並需相容多位元編碼方式如UTF-8
除非要刻意忽略錯誤，使用system call必定檢查回傳值，並使用perror或strerror等方式列印出錯誤訊息
使用mallic及relloc一定要檢查回傳值是否為NULL。當使用relloc要求分配比原本空間更小時更需要注意，因為實作關係可能最後分配的空間block可能和原本的不同
使用free後就不要留戀還在裏面的資料了吧
一旦malloc出現錯誤時，非互動程式請將他視為嚴重錯誤。互動程式就儘早自殺(abort())吧
使用getopt_long處理命令列參數
避免操作低階UNIX介面，以減少相容性問題
在程式中檢查到不可能發生的狀況，直接給他死。既然不可能發生了，顯然那邊出大問題，儘早發現儘早處理。因為就是不可能發生，而死掉一定從這邊找起，寫程式時就在這邊提供更多註解和資訊吧
使用全域變數或static 變數儘量給初值。（不確定是否有看懂，出處）
不要從回傳值傳回發生錯誤的次數，因為只有256個狀態而已，很容易overflow的。
使用存放暫存檔到$TMP_DIR環境變數而不是閉著眼睛寫到/tmp下面
同樣的，暫存檔請將權限設為0600確保資訊不會洩漏

儘量讓函數reentrant
Name covention 很重要，因為library是給別人用，粗心大意就出現name conflict 的問題，以下是GNU的建議
- external 函數和變數需加prefix，prefix為兩個字元以上（後面英文太爛看不懂）
- external 但是不想讓使用者看到（或是文件不會提到的）的函數以_開頭加上prefix用來辨識這是內部函數
- 內部static 就請自便

很奇怪的，單字句子都看懂，就是不懂他要表達啥。只能猜測說不要生出一堆很功能類似的執行檔，而是用最少執行檔加上參數取代。以及執行檔儘量device independent

檔案有可能會存放在readonly FS，如果要寫東西寫到必定是可寫的目錄如/var或是/tmp目錄中

#ifdef ASDF
...
#else  /* ASDF */
...
#endif /* not ASDF */

#ifnef QWER
...
#endif /* not QWER */

/* Bad */
int i_am_bad, i_am_super_bad;

/* Good */
int i_am_good   = 0;
int i_am_better = 0;

/* Bad */
if ((my_id = get_id(my_record)) != NONE) {
    /* Prcess data */
}
else {
    return NO_DATA;
}

/* Good */
my_id = get_id(my_record);
if (my_id == NONE) {
    return NO_DATA;
}
/* Prcess data */