match - script and chart function
The match function compares the first parameter with all the following ones and returns the numeric location of the expressions that match. The comparison is case sensitive.
Syntax:
match( str, expr1 [ , expr2,...exprN ])
Some of the examples in this topic use inline loads. For more information, see Inline loads.
Example: Load script using match
Load script
You can use match to load a subset of data. For example, you can return a numeric value for an expression in the function. You can then limit the data loaded based on the numeric value. Match returns 0 if there is no match. All expressions that are not matched in this example will therefore return 0 and will be excluded from the data load by the WHERE statement.
Create a new tab in the data load editor, and then load the following data as an inline load. Create the table below in Qlik Sense to see the results.
Transactions:
Load * Inline [
transaction_id, transaction_date, transaction_amount, transaction_quantity, customer_id, size, color_code
3750, 20180830, 23.56, 2, 2038593, L, Red
3751, 20180907, 556.31, 6, 203521, m, orange
3752, 20180916, 5.75, 1, 5646471, S, blue
3753, 20180922, 125.00, 7, 3036491, l, Black
3754, 20180922, 484.21, 13, 049681, xs, Red
3756, 20180922, 59.18, 2, 2038593, M, Blue
3757, 20180923, 177.42, 21, 203521, XL, Black
];
/*
Create new table called Transaction_Buckets
Create new fields called Customer, and Color code - Blue and Black
Load Transactions table.
Match returns 1 for 'Blue', 2 for 'Black'.
Does not return a value for 'blue' because match is case sensitive.
Only values that returned numeric value greater than 0
are loaded by WHERE statment into Transactions_Buckets table.
*/
Transaction_Buckets:
Load
customer_id,
customer_id as [Customer],
color_code as [Color Code Blue and Black]
Resident Transactions
Where match(color_code,'Blue','Black') > 0;
Results
Color Code Blue and Black | Customer |
---|---|
Black | 203521 |
Black | 3036491 |
Blue | 2038593 |
Examples - Chart expressions using match
Chart expression 1
Load script
Create a new tab in the data load editor, and then load the following data as an inline load. After loading the data, create the chart expression examples below in a Qlik Sense table.
MyTable:
Load * inline [Cities, Count
Toronto, 123
Toronto, 234
Toronto, 231
Boston, 32
Boston, 23
Boston, 1341
Beijing, 234
Beijing, 45
Beijing, 235
Stockholm, 938
Stockholm, 39
Stockholm, 189
zurich, 2342
zurich, 9033
zurich, 0039];
The first expression in the table below returns 0 for Stockholm because 'Stockholm' is not included in the list of expressions in the match function. It also returns 0 for 'Zurich' because the match comparison is case-sensitive.
Cities | match( Cities,'Toronto','Boston','Beijing','Zurich') | match( Cities,'Toronto','Boston','Beijing','Stockholm','zurich') |
---|---|---|
Beijing |
3 |
3 |
Boston | 2 | 2 |
Stockholm | 0 | 4 |
Toronto | 1 | 1 |
zurich | 0 | 5 |
Chart expression 2
You can use match to perform a custom sort for an expression.
By default, columns sort numerically or alphabetically, depending on the data.
Cities |
---|
Beijing |
Boston |
Stockholm |
Toronto |
zurich |
To change the order, do the following:
- Open the Sorting section for your chart in the Properties panel.
- Turn off auto sorting for the column on which you want to do a custom sort.
- Deselect Sort numerically and Sort alphabetically.
-
Select Sort by expression, and then enter an expression similar to the following:
=match( Cities, 'Toronto','Boston','Beijing','Stockholm','zurich')
The sort order on the Cities column changes.
Cities |
---|
Toronto |
Boston |
Beijing |
Stockholm |
zurich |
You can also view the numeric value that is returned.
Cities | Cities & ' - ' & match ( Cities, 'Toronto','Boston', 'Beijing','Stockholm','zurich') |
---|---|
Toronto | Toronto - 1 |
Boston | Boston - 2 |
Beijing | Beijing - 3 |
Stockholm | Stockholm - 4 |
zurich | zurich - 5 |