dio_raw_to_enum_value_text_c

	status.i4.v = dio_raw_to_enum_value_text_c(device_indices.i4a.r,
						   properties.i2a.r,
						   raw_data.g.v,
						   enum_value_text.i1a.r,
						   errors.i2a.r
						   [,num_devices.i4.v]
						   [,lengths.i4a.r]
						   [,options.u4.v])

	This routine converts raw reading/setting data to its corresponding
	enumerated value text.

	device_indices	device index or array of device indices
	properties	property index or array of property indices
			(PRREAD -> reading property,
			 PRSET -> setting property)
			(If the first value is less than zero, all devices
			 will be requested with a property index which is
			 equal to the absolute value of this argument.)
	raw_data	raw reading data returned
	enum_value_text	returned enumerated value text
			(allow DIO_ENUM_VALUE_TEXT_LEN or
			 DIO_ENUM_VALUE_SHORT_TEXT_LEN characters
			 per entry depending on whether "long text"
			 is requested)
			(Note: If null terminated strings are requested,
			 allow an extra character in each case for the null.)
	errors		returned ACNET status value or array of returned
			status values
	[num_devices]	number of devices in list
			(default is 1)
	[lengths]	device length or array of lengths for support of
			array devices  (If the first value is less than zero,
			all devices will use a length which is equal to the
			absolute value of this argument.)
			(Passing a value of NULL results in using the database
			 default size for each device.)
			(default is NULL)
	[options]	enumerated text options
			(DIO_OPT_NONE -> no options selected (return "short"
					 strings) (DIO_ENUM_VALUE_SHORT_TEXT_LEN
					 characters per entry)(default),
			 DIO_OPT_LONG_TEXT -> return "long" text
					      (DIO_ENUM_VALUE_TEXT_LEN
					       characters per entry),
			 DIO_OPT_NULL_TERMINATE -> return null terminated
						   strings)

	This function returns status values as follows:

	OK			success
	DIO_MEMFAIL		memory allocation failure
	DIO_INVLEN		an invalid device length was requested for
				one or more devices
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	cns_data_structs_h, dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_enum_value_info_c, dio_raw_to_value_text_c, dio_raw_to_status_text,
	dio_raw_to_status_text_extended_c, dio_raw_to_status_c,
	dio_raw_to_status_extended_c, dio_raw_to_scaled_data(_c),
	dio_raw_to_scaled_custom_c, dio_primary_to_scaled_custom_c,
	dio_scaled_to_raw_custom_c, dio_get_raw(_c), dio_bld_get_raw(_c),
	dio_get_lst_raw(_c), error_in_list(_c)

	C/C++ usage:

	char	raw_data[TOTAL_LENGTH];
	char	enum_value_text[NUM_DEVICES][DIO_ENUM_VALUE_TEXT_LEN];
	static const short	properties[NUM_DEVICES] = {PRREAD, PRREAD};
	short	errors[NUM_DEVICES];
	int	status;
	static const int	device_indices[NUM_DEVICES] = {14430, 14431};
	int	num_devices = NUM_DEVICES;
	int	*lengths = (int *) NULL;
	unsigned int	options = DIO_OPT_LONG_TEXT;

	status = dio_raw_to_enum_value_text_c(device_indices,properties,
					      (void *) raw_data,
					      (char *) enum_value_text,errors,
					      num_devices,lengths,options);