dio_enum_value_text_to_raw_data_c

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

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

	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.)
	enum_value_text	enumerated value text strings to convert
			(DIO_ENUM_VALUE_TEXT_LEN + 1 characters per entry)
	raw_data	returned reading data values
	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
			 minimum size for each device.)
			(default is NULL)
	[options]	conversion options (not used)
			(default is 0)

	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_enum_value_text_c,
	dio_scaled_to_raw_data(_c), dio_scaled_to_raw_custom_c,
	dio_set_raw(_c), dio_bld_set_raw(_c), dio_set_lst_raw(_c),
	error_in_list(_c)

	C/C++ usage:

	static const char	enum_value_text[NUM_DEVICES][DIO_ENUM_VALUE_TEXT_LEN+1] = {
	"string 1", "string 2", "string 3"};
	char	raw_data[TOTAL_LENGTH];
	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 = 0;

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