clib_fscanf

	num_converted.i4.v = clib_fscanf(stream.s.r, format_string.i1a.r
					 [,value_1, value_2, ...])

	This routine emulates the action of fscanf while also supporting
	site specific data conversions.  In addition to the standard fscanf
	conversion types, the format string can contain '%F' format specifiers.
	This type allows access to all of the site-specific conversion types
	provided by the routine ascii_to_numeric(_c).  This type requires a
	minimum of two arguments.  The first is an integer which contains the
	conversion type.  These constants can be found in 'cbslib'.  Please,
	see the help for ascii_to_numeric(_c) for further information on
	these types.  The second argument is the pointer to the location
	where the converted value should be deposited.  The field width
	for a '%F' conversion can either be specified by an integer in
	the format string or by an asterisk operator in the case of string
	data.  If the asterisk operator is used for string data, its value
	is the first argument with the conversion type being the second
	argument and the value being converted being the third argument.
	Otherwise, an asterisk indicates that the conversion value should
	be discarded.  If the field width is specified, that will determine
	the width of the corresponding input field.  Fields can be delimited
	by a list of terminator characters passed in the argument list
	corresponding to a format specifier of "%T".  This string of
	characters will be used to determine field boundaries until another
	"%T" format specifier is encountered.  To revert to the standard of
	separating fields by white space, pass a null pointer for a "%T"
	format specifier.  A similar special format specifier is "%M".  This
	specifier results in subsequent input fields being terminated by the
	first character which does not match the list of characters passed
	in the argument corresponding to the "%M" format specifier.  It is
	important to note that an asterisk within a format specifier for
	string data serves to indicate a field width argument in the argument
	list much like sprintf rather than to indicate assignment suppression
	as in fscanf.

	stream		file stream
	format_string	null terminated string which contains the
			characters to be compared literally or converted
			as specified by the optional value arguments
	[value_1...]	optional values which correspond to conversion
			expressions in the format string

	This function returns status values as follows:

	CLIB_END_OF_FILE	no text was available from the file
	CLIB_NULL_VALUE		zero length input field encountered
	CLIB_CONVERSION_ERROR	conversion error
	CLIB_MISMATCH		literal text between fields did not match
				format string
	otherwise		number of values converted

	This function requires the following include files:

	cbslib_h

	Related functions:

	clib_sscanf, clib_n_sscanf_c, ascii_to_numeric(_c),
	window_input_value(_c), sscanf, numeric_default_length_c,
	clib_sprintf, clib_sprintfx, clib_vsprintf, clib_vsprintfx,
	clib_printf, clib_fprintf

	C/C++ usage:

	static const char	format_string[] = "%F %F";
	int	num_converted;
	int	device_index;
	int	color;
	FILE	*stream;

	num_converted = clib_fscanf(stram,format_string,
				    CNV_DEVICE,&device_index,CNV_COLOR,&color);