IPS_SupportsSearching

 bool IPS_SupportsSearching (int $InstanceID) 

Parameters

Returns

If the instance supports the search mode, TRUE is returned, otherwise FALSE.

Description

The function checks whether the module of the instance with the ID InstanceID supports a search mode that can be started with IPS_StartSearch. For an instance that does not exist, it fails with "Instance #... does not exist".

Some device modules support a search mode, e.g. the instances for FS20, HMS, EnOcean or HomeMatic. In search mode, the instance reports every received device with its address, together with an existing instance for this address. The management console shows these results in the search dialog, so a device can be found by triggering it and then be assigned to the instance. The search mode ends automatically after 5 minutes.

The entry InstanceSupportsSearching of IPS_GetInstance contains the same information.

Example

if (IPS_SupportsSearching(12345)) {
    echo 'The instance supports the search mode';
}