10.3.1 映射文件中的文件格式

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 文件中不允许出现重复的映射表名称。

10.3.1.1 将其他文件包含到映射文件中

可以将其他文件包含到 mappings 文件中。这可以通过以下格式的行来实现：

<file-spec
            

它可以有效地将文件 file-spec 的内容替换到 mappings 文件中包含出现的位置。文件规范应指定一个完整文件路径（目录等）。以此方式包括的所有文件都必须可由所有用户读取。此类包含的 mappings 文件中还允许具有注释。包括最多可以嵌套三层。装入 mappings 文件的同时会装入包含的文件—不是需要时才将其装入，因此 使用包含的文件时不涉及性能或内存的节省。