縮略字是從詞彙或片語中的單字字母所組成的單字。例如,HTML 是 Hypertext Markup Language (超文字標記語言) 的縮略字。只有當縮略字是大家所瞭解及熟知時,才應該在識別項中加入縮略字。縮略字與縮寫不同之處是縮寫會縮短單一個字母。例如,ID 是 identifier 的縮寫。一般來說,程式庫名稱不應該使用縮寫。
注意事項: |
|---|
可用於識別項中的兩個縮寫是 ID 和 OK。在 Pascal 命名法的大小寫慣例的識別項中,它們應該以 Id 和 Ok 的形式出現。如果它們是當做 Camel 命名法的大小寫慣例的識別項中的第一個單字,則分別應該以 id 和 ok 的形式出現。 |
縮略字的大小寫需視縮略字的長度而定,所有縮略字的長度至少都有兩個字元;為了要在這些方針中說明,如果縮略字剛好為兩個字元,會將它視為短縮略字;三個字元以上 (含) 的縮略字則為長縮略字。
下列方針將指定短縮略字和長縮略字的適當大小寫慣例,識別項的大小寫規則優先於縮略字的大小寫規則。
要將兩個字元縮略字的兩個字元都變成大寫,除了 Camel 命名法的大小寫慣例的識別項之第一個單字以外。
名為 DBRate 的屬性是當做 Pascal 命名法的大小寫慣例的識別項之第一個單字使用的短縮略字 (DB) 範例;名為 ioChannel 的參數則是當做 Camel 命名法的大小寫慣例的識別項之第一個單字使用的短縮略字 (IO) 範例。
只要將具有三個或三個以上字元的縮略字之第一個字母變成大寫,但是 Camel 命名法的大小寫慣例的識別項之第一個單字除外。
名為 XmlWriter 的類別是當做 Camel 命名法的大小寫慣例的識別項之第一個單字使用的長縮略字範例;名為 htmlReader 的參數則是當做 Camel 命名法的大小寫慣例的識別項之第一個單字使用的長縮略字範例。
不要將位於 Camel 命名法的大小寫慣例的識別項開頭的任何縮略字的任何字元變成大寫,不論其長度為何。
名為 xmlStream 的參數是當做 Camel 命名法的大小寫慣例的識別項之第一個單字使用的長縮略字 (xml) 範例;名為 dbServerName 的參數則是當做 Camel 命名法的大小寫慣例的識別項之第一個單字使用的短縮略字 (db) 範例。