對映檔案中的檔案格式

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 指定的任何內容。每個式樣或範本最多可包含 252 個字元。對映中可以顯示的項目數不受限制 (儘管項目過多會消耗大量的 CPU 資源以及過多的記憶體)。較長的行 (超過 252 個字元) 可以使用反斜線 (\) 結束，以在下一行繼續。兩欄之間的空格以及第一欄之前的空格不能省略。

mappings 檔案中不允許出現重複的對映表名稱。

在對映檔案中包含其他檔案

可以在 mappings 檔案中包含其他檔案。這可以使用以下格式的行來實現：

<file-spec
            

它可以有效地將檔案 file-spec 的內容替換至 mappings 檔案中包含出現的位置。檔案規格應指定完整的檔案路徑 (目錄等)。以此方式包含的所有檔案必須可由所有人讀取。此類包含的 mappings 檔案中還可以包含註釋。包含最多可以嵌套三層。載入 mappings 檔案的同時會載入包含檔案 — 它們不是按需載入的，因此使用包含檔案不涉及效能或記憶體的節省。