# MapSubstring — функция скрипта

Функция скрипта MapSubstring используется для сопоставления частей выражения с загруженной таблицей сопоставления. Сопоставление выполняется с учетом регистра и не является итеративным, причем подстроки сопоставляются слева направо.

Синтаксис:

MapSubstring('map\_name', expression)

Возвращаемые типы данных: строка

Аргументы:

Аргументы

| Аргумент | Описание |
| --- | --- |
| map\_name | Имя таблицы сопоставления, считанной ранее оператором mapping load или mapping select. Имя должно быть заключено в одинарные прямые кавычки.<br><br>Примечание к предупреждениюЕсли функция используется в развернутой переменной макроса со ссылкой на несуществующую таблицу сопоставления, происходит сбой вызова функции и поле не создается. |
| expression | Выражение, результат которого должен быть сопоставлен по подстрокам. |

Пример:

В этом примере мы загружаем список моделей продукта. Каждая модель имеет набор атрибутов, которые описываются составным кодом. С помощью таблицы сопоставления с MapSubstring мы можем расширить коды атрибутов до описания.

```
map2:
mapping LOAD * 
Inline [
AttCode, Attribute
R, Red
Y, Yellow
B, Blue
C, Cotton
P, Polyester
S, Small
M, Medium
L, Large
] ;

Productmodels:
LOAD *,
MapSubString('map2', AttCode) as Description
Inline [
Model, AttCode
Twixie, R C S
Boomer, B P L
Raven, Y P M
Seedling, R C L
SeedlingPlus, R C L with hood
Younger, B C with patch
MultiStripe, R Y B C S/M/L 
] ;
// We don't need the AttCode anymore
Drop Field 'AttCode';
```

Полученная таблица выглядит следующим образом:

Resulting table

| Model | Description |
| --- | --- |
| Twixie | Red Cotton Small |
| Boomer | Blue Polyester Large |
| Raven | Yellow Polyester Medium |
| Seedling | Red Cotton Large |
| SeedlingPlus | Red Cotton Large with hood |
| Younger | Blue Cotton with patch |
| MultiStripe | Red Yellow Blue Cotton Small/Medium/Large |

## Подробнее

* [](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/Mapping.htm)[Сопоставление](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/Mapping.htm)
* [Использование кавычек в скрипте](https://help.qlik.com/ru-RU/sense/May2025/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm)