dio_value_text_to_raw_data_c

	status.i4.v = dio_value_text_to_raw_data_c(device_indices.i4a.r,
						   properties.i2a.r,
						   convert_type.i4.v,
						   value_length.i4.v,
						   value_strings.i1a.r,
						   errors.i2a.r,
						   raw_data.g.v
						   [,lengths.i4a.r]
						   [,num_devices.i4.v]
						   [,options.u4.v])

	This routine converts null terminated scaled value text strings
	to raw reading or 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
			 use a property index which is equal to the absolute
			 value of this argument.)
	convert_type	type of scaling conversion desired
			(DIO_COMMON -> scale from common engineering units,
			 DIO_PRIMARY -> scale from primary units,
			 DIO_RAW -> scale from raw hex string)
	value_length	number of characters for each value
			(not including the null terminator)
	value_strings	null terminated value strings or array
			of strings
			("value_length" + 1 characters per device)
	errors		returned ACNET status value or array of returned
			status values
	raw_data	returned raw reading or setting data
	[lengths]	returned raw data lengths
			(default is NULL)
	[num_devices]	number of devices to convert
			(default is 1)
	[options]	scaling options
			(DIO_OPT_NONE -> no options selected (default))

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid property index or conversion type
	DIO_MEMFAIL		memory allocation failure
	negative value		other ACNET format error
	positive value		number of devices in error

	This function requires the following include files:

	dbprops_h, diolib_h, acnet_errors_h

	Related functions:

	dio_value_text_c, dio_scaled_to_raw_data(_c),
	dio_scaled_to_raw_custom_c, dio_enum_value_text_to_raw_data_c,
	dio_raw_to_value_text_c, dio_raw_to_value_text_custom_c,
	dio_scaled_to_value_text_c, dio_raw_to_scaled_data(_c),
	dio_primary_to_scaled_data_c, dio_scaling, dio_data_len(_c),
	dio_enum_value_info_c, dio_set_raw(_c), dio_set_lst_raw(_c),
	dio_get_pdb, dio_raw_to_status_c, dio_raw_to_status_extended_c,
	dio_raw_to_status_text, dio_raw_to_status_text_extended_c,
	dio_raw_to_scaled_custom_c, dio_primary_to_scaled_custom_c,
	dio_data_type_info_c, error_in_list(_c)

	C/C++ usage:

	static const char	value_strings[DIO_LONG_DISPLAY_LEN+1] = " 2.456";
	short	raw_data;
	short	error;
	short	property = PRSET;
	int	status;
	int	device_index = 14430;
	int	convert_type = DIO_COMMON;
	int	value_length = DIO_LONG_DISPLAY_LEN;
	int	num_devices = 1;
	int	*lengths = (int *) NULL;
	unsigned int	options = DIO_OPT_NONE;

	status = dio_value_text_to_raw_data_c(&device_index,&property,
					      convert_type,value_length,
					      value_strings,&error,
					      (void *) &raw_data,lengths,
					      num_devices,options);