clib_sprintf

	num_chars.i4.v = clib_sprintf(output_string.i1a.r, format_string.i1a.r
				      [,value_1, value_2, ...])

	This routine emulates the action of sprintf while also supporting
	site specific data conversions.  In addition to the standard sprintf
	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 numeric_to_ascii(_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 numeric_to_ascii(_c) for further information on
	these types.  The second argument is the actual data.  The field width
	for a '%F' conversion can either be specified by an integer in
	the format string or by an asterisk operator.  If the asterisk
	operator is used, its value is the first argument with the
	conversion type being the second argument and the value being
	converted being the third argument.  There is no precision
	specification supported for "%F" conversions.  If the field width,
	is specified, that will determine the width of the corresponding
	field in the output.  A field width with a leading zero will result
	in padding the output with zeroes.  In addition to field width, the
	justification of an output field can be specified by inserting a
	minus character ('-') for left, a plus character ('+') for right,
	or a caret ('^') character for center justification.  The "%F"
	operator is most appropriate if used only with site-specific
	conversion types.  Another special format specifier available from
	this routine is "%P".  This allows the caller to specify that the
	output pointer be positioned to a particular character cell.  This
	type requires one integer argument which is the character cell number
	(starting at 1).  If the desired position is greater than the present
	position of the pointer, the interim characters will be filled with
	blanks.  This feature is useful for producing aligned output columns.
	A string of like characters can be included in the output text
	through the use of the %I format specifier.  This specifier requires
	two arguments.  The first is the character to insert, and the
	second is the number of characters to insert.  If the number of
	characters is negative, this format specifier works similarly to
	the %P format specifier except for the fact that the specified fill
	character is used in place of blanks.  Capitalization of text can be
	altered with the "%K" format specifier.  This takes a single argument
	which indicates the desired character case for future output text.
	The values for this argument are the same as those for the routine
	str_case_c.  There is also a format specifier to suppress the null
	terminator in the output string.  This is specified by "%N".  There
	is also optional protection against writing beyond the end of the
	output buffer.  The "%L" format specifier allows the caller to pass
	the length of the output buffer.

	output_string	returned null terminated string
	format_string	null terminated string which contains the
			characters to be written 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_TOO_BIG		output string was too long for buffer
	otherwise		number of characters output

	This function requires the following include files:

	cbslib_h

	Related functions:

	clib_sprintfx, clib_vsprintf, clib_vsprintfx, sprintf,
	clib_printf, clib_fprintf, numeric_to_ascii(_c),
	numeric_default_length_c, str_case_c, window_printf_c,
	window_printf_noscroll_c, window_printf_at_c,
	window_display_value(_c), error_printf_c, error_mprintf_c,
	error_cmprintf_c

	C/C++ usage:

	static const char	format_string[] = "The device name is %F.";
	char	output_string[128];
	int	num_chars;

	num_chars = clib_sprintf(output_string,format_string,
				 CNV_DEVICE,27235);