ISVALUE

The ISVALUE function tests whether a dimension or a composite has a specified value.

Return Value

BOOLEAN

Syntax

ISVALUE(name, value)

Arguments

name

The name of the dimension or the composite to be checked.

When the composite is unnamed, use the SPARSE keyword to refer to the composite (for example, SPARSE <market product>).

value

The value you want to test, either a text literal or text expression for an ID or TEXT dimension, an integer for an INTEGER dimension, or a combination of values enclosed by angle brackets for composites and conjoint dimensions.

Notes

Compared to INSTAT

ISVALUE tells you whether an item is a value of a dimension, but not whether a dimension value is in the current status. The INSTAT function, on the other hand, tells you whether a value of a dimension is in the current status of the dimension.

Examples

Example 15-22 Testing Valid Values

Suppose you want to find out if Packs is a value of the product dimension. The following statement produces the answer YES or NO.

SHOW ISVALUE(product, 'Packs')

Example 15-23 Embedding Quoted Strings

You can embed quoted strings within a quoted string, which is necessary when there are special characters in a base dimension value of a composite or conjoint dimension, such as Joe's Deli. Suppose you want to find out if New York and Apple Sauce are a valid combination of base dimension values in the markprod conjoint dimension. The following statement produces the answer YES or NO.

SHOW ISVALUE(markprod, '<\'New York\' \'Apple Sauce\'>')

When embedded quoted strings have a further level of embedding, you must use backslashes before each special character, such as the apostrophe and the backslash that must precede it in "Joe's Deli," as shown in the following statement.

SHOW ISVALUE(markprod, '<\'Joe\\\'s Deli\' \'Apple Sauce\'>')

Example 15-24 Testing Logical Position Numbers

You can test for the logical position numbers of base dimension values in a conjoint dimension. For example, suppose market and product are the base dimensions of the conjoint dimension markprod. The following statement tests whether or not there is a value assigned to the combination of the fourth market dimension value and the third product dimension value.

SHOW ISVALUE(markprod, '<4 3>')