X 視窗程式設計/XLib/庫約定
外觀
Xlib 遵循一些約定,使其更易於使用和記憶。
主要的約定是
- 為了區分 X 符號與其他符號,庫對外部符號名使用混合大小寫。它對變數使用小寫字母,對使用者宏使用全大寫字母,遵循現有約定。
- 所有 Xlib 函式、使用者可見的資料結構以及使用者可能取消引用的任何內容都以大寫字母 X 開頭。
- 宏和其他符號不以大寫字母 X 開頭。為了將它們與所有使用者符號區分開來,宏中的每個單詞都大寫。
- 所有函式名和符號的開頭都大寫。
- 資料結構的所有元素都使用小寫字母。需要時,複合詞使用下劃線 (_) 構造。
- 顯示引數,如果使用,始終位於引數列表中的第一位。
- 所有資源物件,如果使用,都出現在引數列表的開頭,緊接在顯示引數之後。
- 當圖形上下文與其他型別的資源(最常見的是可繪製物件)一起出現時,圖形上下文出現在引數列表中的其他資源之後。可繪製物件優先於所有其他資源。
- 源引數始終位於引數列表中的目標引數之前。
- x 引數始終位於引數列表中的 y 引數之前,寬度引數始終位於引數列表中的高度引數之前。
- 當 x、y、寬度和高度引數一起使用時,x 和 y 引數始終位於寬度和高度引數之前。
- 當掩碼與結構一起使用時,掩碼始終位於引數列表中指向結構的指標之前。