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

Work with data container (actions CNT_...).

Related pages:

Script actions