calc_line_length_c

	success.i4.v = calc_line_length_c(text.i1a.r, max_length.i4.v,
					  num_chars.i4.r [,term_char.i1.v]
					  [,next_char.i1.r] [,text_length.i4.v])

	This routine will calculate the maximum number of characters
	that will fit on a line of length "max_length" without breaking
	at a word boundary.

	text		text to be broken
	max_length	maximum number of characters to put on the line
	num_chars	returned number of characters in the line
	[term_char]	special termination character to look for
			(default is BLANK)
	[next_char]	returned next character in the string
			(default is NULL)
	[text_length]	total length of text buffer
			(default is 0 which results in the text buffer
			 being limited only by "max_length")

	This function returns status values as follows:

	TRUE			successfully broke the string
	FALSE			string was too int to fit on line

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	decide(_c), decide_multiple_c, acknowledge(_c)

	C/C++ usage:

	static const char	text[] = "This is a line of text.";
	char	term_char = BLANK;
	char	next_char;
	int	success;
	int	max_length = LINE_LENGTH;
	int	num_chars;
	int	text_length = 0;

	success = calc_line_length_c(text,max_length,&num_chars,term_char,
				     &next_char,text_length);