CONTAINS
Syntax
CONTAINS(<string or list>;<string>)
Description
Returns a Boolean value if the string contains the desired characters (2nd argument) or not. This operation is case sensitive. CONTAINS returns false if one of the arguments is <null>.
Examples
Column1 (string) | Contains | CONTAINS returns |
---|---|---|
United States | "united states" | false |
United States | "United" | true |
Germany | "Germany" | true |
Germany | "ger" | false |
United Kingdom | "King" | true |
<null> | "King" | false |
United Kingdom | <null> | false |
If the data you are using in your CONTAINS() is a list format data field, the string used to evaluate the element must match the entire element.
Column1 (list) | Contains | CONTAINS returns |
---|---|---|
[United States, Germany] | "United" | false |
[United States, Germany] | "United States" | true |
[United States, Germany] | "germany" | false |
[United States, Germany] | "Ger" | false |
[United States, Germany] | "Germany" | true |
If you have a list data type and want to be able to use the CONTAIN() like a string, you can use TOJSON(), as in the following example.
Column1 (list) | Contains | CONTAINS returns | Column1 TOJSON () | CONTAINS returns |
---|---|---|---|---|
[United States, Germany] | "United" | false | ["United States", "Germany"] | true |
[United States, Germany] | "United States" | true | ["United States", "Germany"] | true |
[United States, Germany] | "germany" | false | ["United States", "Germany"] | true |
[United States, Germany] | "Ger" | false | ["United States", "Germany"] | true |