# Mapping Character Filter **Mapping Character Filter**?接收鍵和值映射作為配置參數，每當在預處理過程中遇到與鍵值映射中的鍵相同的字符串時，就會使用該鍵對應的值去替換它。 原始文本中的字符串和鍵值映射中的鍵的匹配是貪心的，在對給定的文本進行預處理過程中如果配置的鍵值映射存在包含關系，會優先匹配最長鍵。可以用空字符串進行替換。 ## 配置 | 參數名稱 | 參數說明 | | --- | --- | | `mappings` | 一組映射，每個元素的格式為key => value。 | | `mappings_path` | 一個相對或者絕對的文件路徑，指向一個每行包含一個 key =>value 映射的UTF-8編碼文本映射文件。 | 以上兩個參數必須提供一個。 在下面的例子中，我們將使用**Mapping Character Filter**來實現用拉丁語數字和阿拉伯數字的等價替換： **案例** | `PUT my_index` `{` `"settings": {` `"analysis": {` `"analyzer": {` `"my_analyzer": {` `"tokenizer": "keyword",` `"char_filter": [` `"my_char_filter"` `]` `}` `},` `"char_filter": {` `"my_char_filter": {` `"type": "mapping",` `"mappings": [` `"? => 0",` `"? => 1",` `"? => 2",` `"? => 3",` `"? => 4",` `"? => 5",` `"? => 6",` `"? => 7",` `"? => 8",` `"? => 9"` `]` `}` `}` `}` `}` `}` `POST my_index/_analyze` `{` `"analyzer": "my_analyzer",` `"text": "My license plate is ?????"` `}` | 上面的案例將會返回如下結果： | `[ My license plate is 25015 ]` | 鍵和值都可以是具有多個字符的字符串。?以下示例用指定的文本替換 :) 和 :( 表情符號： **案例** | `PUT my_index` `{` `"settings": {` `"analysis": {` `"analyzer": {` `"my_analyzer": {` `"tokenizer": "standard",` `"char_filter": [` `"my_char_filter"` `]` `}` `},` `"char_filter": {` `"my_char_filter": {` `"type": "mapping",` `"mappings": [` `":) => _happy_",` `":( => _sad_"` `]` `}` `}` `}` `}` `}` `POST my_index/_analyze` `{` `"analyzer": "my_analyzer",` `"text": "I'm delighted about it :("` `}` | 上面的案例將會返回如下結果： | `[ I'm, delighted, about, it, _sad_ ]` |