mappings 檔案由一系列獨立表格組成。每個表格以其名稱開頭。名稱的第一欄始終為字母字元。表格名稱後面必須有一個空行,然後是表格中的項目。項目由零個或多個縮排行組成。每個項目行包含兩欄,由一個或多個空格或標籤分隔。項目中的所有空格均必須使用 $ 字元引用。每個對映表名稱之後和每個對映表之間均必須有空行;單一表格中的項目之間不能出現空行。註釋由第一欄中的驚嘆號 (!) 開頭。
結果格式與以下格式類似:
TABLE1_NAME pattern1-1 template1-1 pattern1-2 template1-2 pattern1-3 template1-3 . . . . . . pattern1-n template1-n TABLE2_NAME pattern2-1 template2-1 pattern2-2 template2-2 pattern2-3 template2-3 . . . . . . pattern2-n template2-n . . . TABLE3_NAME . . . |
使用對映表 TABLE2_NAME 的應用程式會將字串 pattern2-2 對映至由 template2-2 指定的任何內容。各模式或範本可個別包含多達 256 個字元和 1024 個字元。對映檔中一行的大小上限為 4096 個字元。對映中可以顯示的項目數不受限制 (儘管項目過多會消耗大量的 CPU 資源以及過多的記憶體)。較長的行 (超過 252 個字元) 可以使用反斜線 (\) 結束,以在下一行繼續。兩欄之間的空格以及第一欄之前的空格不能省略。
mappings 檔案中不允許出現重複的對映表名稱。
可以在 mappings 檔案中包含其他檔案。這可以使用以下格式的行來實現:
<file-spec |
它可以有效地將檔案 file-spec 的內容替換至 mappings 檔案中包含出現的位置。檔案規格應指定完整的檔案路徑 (目錄等)。以此方式包含的所有檔案必須可由所有人讀取。此類包含的 mappings 檔案中還可以包含註釋。包含最多可以嵌套三層。載入 mappings 檔案的同時會載入包含檔案 — 它們不是按需載入的,因此使用包含檔案不涉及效能或記憶體的節省。