Skip to main content
Skip table of contents



This function indicates if the device does or does not exist using its full Address-Code value (See also DeviceExistsAddress, DeviceExistsCode)


Parameter: Address
Type: string
Description: This is the device address with code, such as "Unit1-R66", "0F47ED78-2", or "U2-I45-K2.2-Y55"

Parameter: CaseSensitive
Type: Boolean
Description: When True, the address-code must match exactly.  When false, the address-code match is case insensitive such that apple2-Y65=APPLE2-y65


Return value: status
Type: Integer
Description: Returns -1 if the device does not exist, otherwise it returns the device reference ID number of the device.  The reference number can then be used with the GetDeviceRef function.


Sample Code



  • The address field can contain any string of characters.  The format and value is determined by a plug-in in the event that the device is owned by a plug-in.
  • When retrieved, the Address property includes the Code property, separated by a dash (-) if the Code property is set.  For example, if the Address was set to "Unit1" and the code field is not used, then retrieving the Address field will result in "Unit1".  If the Address was set to "Unit1" and the code was set to "Y55", then retrieving the Address field will result in "Unit1-Y55".
  • When this function is used, the Code field is combined with the Address field.  (See DeviceExistsAddressl to find a device using its address value only.) 
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.