dio_scaled_to_value_text_c

	status.i4.v = dio_scaled_to_value_text_c(device_indices.i4a.r,
						 properties.i2a.r,
						 scaled_data.g.v,
						 data_type.i4.v,
						 num_devices.i4.v, format.i4.v,
						 value_strings.i1a.r,
						 errors.i2a.r, units_text.i1a.r)

	Ths routine converts scaled reading or setting data to null terminated
	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.)
	scaled_data	scaled reading or setting data returned by a previous
			call to dio_get_dev(_c) or dio_get_lst
	data_type	type of scaled data supplied
			(DIO_COMMON -> scaled data is comprised of single
				       precision floats representing values in
				       common engineering units,
			 DIO_COMMON_DOUBLE -> scaled data is comprised of double
					      precision floats representing
					      values in common engineering
					      units,
			 DIO_PRIMARY -> scaled data is comprised of single
					precision floats representing values in
				        primary units,
			 DIO_PRIMARY_DOUBLE -> scaled data is comprised of
					       double precision floats
					       representing values in
					       primary units)
	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
			(DIO_LONG_DISPLAY_LEN + 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.)

	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_c, dio_value_text_c, dio_raw_to_scaled_data(_c),
	dio_primary_to_scaled_data_c, dio_scaled_to_raw_data(_c),
	dio_scaled_to_raw_custom_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, error_in_list(_c)

	C/C++ usage:

	char	value_string[DIO_LONG_DISPLAY_LEN+1];
	char	units_text[LEN_DEV_UNITS+1];
	short	error;
	short	property = PRSET;
	int	status;
	int	device_index = 14430;
	int	ftd = FTD_ONESHOT;
	int	length = 0;
	int	offset = 0;
	int	data_type = DIO_COMMON;
	int	num_devices = 1;
	int	format = DIO_FORMAT_UNIFORM_LENGTH;
	float	scaled_data;

	status = dio_get_dev_c(device_index,property,(void *) &scaled_data,
			       ftd,length,offset,units_text);

	status = dio_scaled_to_value_text_c(&device_index,&property,
					    (void *) &scaled_data,data_type,
					    num_devices,format,value_string,
					    &error,units_text);