str_make_printable_c

	expand_length.i4.v = str_make_printable_c(string.i1a.r, length.i4.v,
						  maximum_length.i4.v,
						  options.u4.v
						  [,replace_char.i1.v])

	This routine will expand any tab characters in a string and
	replace them with blanks and remove or replace any nonprintable
	characters.

	string		string to make printable
	length		length of string  (If this argument has a value
			of zero, the routine will determine the length
			of the string.)
	maximum_length	maximum length of expanded string
	options		use options
			(STR_OPT_NONE -> no options selected,
			 STR_OPT_REPLACE_NONPRINTABLES -> replace nonprintable
							  characters with a
							  blank,
			 STR_OPT_REMOVE_NONPRINTABLES -> remove nonprintable
							 characters (default),
			 STR_OPT_NULL_TERMINATE -> null terminate the string,
			 STR_OPT_SUPPRESS_TABS -> suppress tab characters)
	[replace_char]	replacement character
			(default is BLANK)

	This function returns status values as follows:

	CLIB_INVARG		invalid length passed or maximum length
				is less than the current length
	otherwise		number of non-blank characters

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_remove_nonprintables_c, str_is_printable_c, str_printable_length_c,
	str_expand_tabs_c, str_remove_nonprintables_c, str_remove_spaces_c,
	str_remove_html_tags_c, str_num_nonblank_c, str_is_blank_c,
	str_find_first_c, fndfst, str_get_first_c

	C/C++ usage:

	static char	string[] = "\tMake this string printable.\n";
	char	replace_char = BLANK;
	int	expand_length;
	int	length = 0;
	int	maximum_length = MAXIMUM_LENGTH;
	unsigned int	options = STR_OPT_NULL_TERMINATE;

	expand_length = str_make_printable_c(string,length,maximum_length,
					     options,replace_char);