str_build_text_block_c

	status.i4.v = str_build_text_block_c(string.i1a.r, length.i4.v,
					     line_length.i4.v,
					     num_lines.i4.r,
					     text_block.i1p.r,
					     options.u4.v)

	This routine builds a word wrapped text block from a string.
	The resulting block will be "line_length" by "num_lines" in
	size.  The caller must free the returned block.

	string		initial string to convert
	length		length of string (If a value of zero is passed,
			the length of the string will be calculated.)
	line_length	word wrap line length
	num_lines	returned number of lines in the text block
	text_block	returned pointer to text block
			(memory must be freed by the caller)
	options		use options
			(STR_OPT_NONE -> no options selected)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid line length
	CLIB_MEMFAIL		dynamic memory allocation failure

	This function requires the following include files:

	cbslib_h

	Related functions:

	str_extract_line_c, str_num_lines_c, text_window(_c)

	C/C++ usage:

	static char	string[] = "This is a string which must be wrapped.";
	char	*text_block;
	int	status;
	int	length = 0;
	int	line_length = LINE_LENGTH;
	int	num_lines;
	unsigned int	options = STR_OPT_NONE;

	status.i4.v = str_build_text_block_c(string,length,line_length,
					     &num_lines,&text_block,options);