User Function Reference

User Function - @in

Description:
This user function tests the data represented by a protocol field ID for equality with any of a list of constant values. It provides a convenient way to replace multiple binary equality expressions, ORed together.

Syntax:
@in(PROTOCOL_FIELD_ID, CONSTANT_VALUE1 [, CONSTANT_VALUE2, ..., CONSTANT_VALUEn])

Arguments:

PROTOCOL_FIELD_ID A protocol field identifier in the form <PROTOCOL_ID>:<FIELD_ID>.

CONSTANT_VALUEx A constant value to compare for a match with the data represented by PROTOCOL_FIELD_ID. This argument may be represented as:

an unformatted, numeric string (e.g., 123456789)

a formatted, numeric string (e.g., FF:FF:FF:FF:FF:FF)

a symbolic name alias, enclosed in single quotes, representing a numeric value (e.g., 'My MAC Address')

Returns:
True if any of the constant values is equal to the data represented by the specified protocol, else false.

Example:
The following example tests whether any of the constants 'My MAC Adddress', FF:FF:FF:FF:FF:FF, 0x123AF872B810,or 1234567890are contained within the data field TOK:DLC.DA.

@in(TOK:DLC.DA, 'My MAC Adddress', FF:FF:FF:FF:FF:FF, 0x123AF872B810, 1234567890)

`PROTOCOL_FIELD_ID`	A protocol field identifier in the form `<PROTOCOL_ID>:<FIELD_ID>`.
`CONSTANT_VALUEx`	A constant value to compare for a match with the data represented by `PROTOCOL_FIELD_ID.` This argument may be represented as: an unformatted, numeric string (e.g., `123456789`) a formatted, numeric string (e.g., `FF:FF:FF:FF:FF:FF`) a symbolic name alias, enclosed in single quotes, representing a numeric value (e.g., `'My MAC Address'`)