CNT_FIND action


Declaration
CNT_FIND _hContainer, _key, _value, bFound

Parameters
_hContainer in Identifier of Int type - data container.
_key in Identifier of value in the container.
_value out Value in container, if the value of the parameter _bFound is @TRUE, otherwise the value of the parameter remains unchanged.
_bFound out @TRUE - value exists in the container.
@FALSE - value doesn't exist in the container.

Description
The action finds the value specified by the parameter _key in the data container and returns it in the parameter _value.
If the container doesn't contain a value with specified key, the parameter _bFound gets the value of @FALSE and the value of the parameter _value remains unchanged.
If the container contains a value with specified key, _bFound gets the value of @TRUE and the required value is returned in the parameter _value.

As container may contain various types of values, the parameter _value must be of proper type, otherwise execution of the script is to be stopped.
Example