dio_raw_to_value_text_c

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

	Ths routine converts raw reading or setting data to null terminated
	scaled value text strings.

	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.)
	raw_data	raw reading or setting data returned by a previous
			call to dio_get_raw(_c) or dio_get_lst_raw(_c)
	convert_type	type of scaling conversion desired
			(DIO_COMMON -> scale to common engineering units,
			 DIO_PRIMARY -> scale to primary units,
			 DIO_RAW -> scale to hex characters)
	num_devices	number of devices in list
	format		desired format of output string
			(DIO_FORMAT_NO_SPACES -> no leading or trailing blanks,
			 DIO_FORMAT_SPACE_PADDED -> blank padded to the default
						    length for that device,
			 DIO_FORMAT_UNIFORM_LENGTH -> blank padded to a length
						      of DIO_LONG_DISPLAY_LEN)
	value_strings	returned null terminated value string or array
			of strings
			("value_length" + 1 characters per device)
	errors		returned ACNET status value or array of returned
			status values
	units_text	returned units text string or array of strings
			(LEN_DEV_UNITS + 1 characters per device)
			(A value of NULL can be passed for this argument
			 if units text is not needed.)
	[value_length]	number of characters for each value
			(default is DIO_LONG_DISPLAY_LEN)
	[options]	scaling options
			(DIO_DISPLAY_OPT_NONE -> no options selected,
			 DIO_DISPLAY_OPT_ALLOW_TRUNCATED -> allow truncated
							    display strings,
			 DIO_DISPLAY_OPT_NULL_TERMINATE -> null terminate after
							   last nonblank
							   character,
			 DIO_DISPLAY_OPT_LONG_TEXT -> request long text for
						      devices which have both
						      short and long text
						      options)
	[raw_length]	raw data length in bytes (only used for string devices)
			(default is 0 which results in using the atomic
			 data length for that property or the passed
			 value length)

	This function returns status values as follows:

	OK			success
	DIO_BADARG		invalid property index, conversion type,
				or format type passed
	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_raw_to_value_text_custom_c, dio_value_text_to_raw_data_c,
	dio_scaled_to_value_text_c, dio_value_text_c,
	dio_raw_to_scaled_data(_c), dio_primary_to_scaled_data_c,
	dio_scaled_to_raw_data(_c), dio_get_dev(_c), dio_bld_get(_c),
	dio_get_lst, dio_get_raw(_c), dio_bld_get_raw(_c),
	dio_get_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_scaled_to_raw_custom_c,
	dio_data_type_info_c, error_in_list(_c)

	C/C++ usage:

	char	value_string[DIO_LONG_DISPLAY_LEN+1];
	char	units_text[LEN_DEV_UNITS+1];
	short	raw_data;
	short	error;
	short	property = PRSET;
	int	status;
	int	device_index = 14430;
	int	ftd = FTD_ONESHOT;
	int	length = 0;
	int	offset = 0;
	int	convert_type = DIO_COMMON;
	int	num_devices = 1;
	int	format = DIO_FORMAT_UNIFORM_LENGTH;
	int	value_length = DIO_LONG_DISPLAY_LEN;
	int	raw_length = 0;
	unsigned int	options = DIO_DISPLAY_OPT_NONE;

	status = dio_get_raw_c(device_index,property,(void *) &raw_data,
			       ftd,length,offset);

	status = dio_raw_to_value_text_c(&device_index,&property,
					 (void *) &raw_data,convert_type,
					 num_devices,format,value_string,
					 &error,units_text,value_length,
					 options,raw_length);