--- title: "categorical-match" slug: "categorical-match-parser" updated: 2022-07-27T21:16:17Z published: 2022-07-27T21:16:17Z canonical: "code.tag.bio/categorical-match-parser" --- > ## Documentation Index > Fetch the complete documentation index at: https://code.tag.bio/llms.txt > Use this file to discover all available pages before exploring further. # categorical-match The *categorical-match* **parser** will evaluate or load data from a single column in comparison with a categorical constant *value*. Depending on the value of the *operator* attribute, the column's data will evaluate to *true*, *false*, or *null*. It inherits attributes and behaviors from its parent: abstract **parser** - *boolean*. ## Attribute - operator The *operator* attribute is required. ``` { "parser_type": "categorical-match", "column": "cccc", "value": "vvvv", // The operator attribute defines a comparison function. // Options include: // "=" - equals // "!=" - not equals // "_=" - lowercase equals // "_!=" - lowercase not equals // "contains" - column value contains the constant value // "!contains" - column value does not contain the constant value // "_contains" - lowercase contains // "_!contains" - lowercase not contains // "is null" - column value is null // "not null" - column value is not null // "operator": "=" } ``` ## Attribute - value Either the *value* or *values* attribute is required, except in the case where the *operator* attribute is: "is null", or "not null". ``` { "parser_type": "categorical-match", "column": "cccc", "operator": "=", // The value attribute defines a constant value against which // the parser will evaluate dynamic values from the column. // "value": "vvvv" } ``` ## Attribute - values Either the *value* or *values* attribute is required, except in the case where the *operator* attribute is: "is null", or "not null". ``` { "parser_type": "categorical-match", "column": "cccc", "operator": "=", // The values attribute defines an array of constant values // against which the parser will evaluate dynamic values // from the column. // // values can be an array of numeric or categorical values, // depending on the parser's needs // "values": [ "A", "B", "etc" ] } ```