Converts a value of any data type to a Categorical value.

There is no equivalent function in Visual Basic.

The result of the conversion depends on the data type of <value>, as follows:

Long: The return value contains a single category whose value is <value>.

Text: The function parses the string as a comma-separated list of either category values or names. Category values must be of the form "{1,2,0}", and the return value contains each listed value, in the order given. Category names must be of the form "{married,single,widowed,other}", which the function will convert to a list of category values. You can omit the braces if the value to be converted is a single category value or name. Note that <value> cannot consist of a category expression.

The conversion of category names to values is possible only when the case data is opened with an MDM document, or when a script has an open MDM document available to it. For more information about opening a MDM document in a script, see Value resolution.

Categorical: <value> is returned unchanged.

Double, Date, or Boolean: An error occurs.

Object: If the object has a default property, the value of that property is converted. Otherwise an error occurs.

NULL value: If <value> is NULL, the return value is an empty Categorical value ({}).

1 This example assumes that the museum sample MDM document is available to the function.