str_extract_line_c

	output_length.i4.v = str_extract_line_c(source_string.i1a.r,
						offset.i4.r
						output_string.i1a.r,
						line_length.i4.v
						[,max_return.i4.v])

	This routine extracts a line of text from an input string and
	copies it into a caller-supplied output string.  the input string is
	then updated to point immediately following The output string is always
	null terminated.  Lines are broken at space, tab, slash (/), or dash
	(-) characters.  Lines will also end if a null character or new line is
	encountered.

	source_string	address of pointer to input string.
	offset		(Address of) the offset in the original string of the
			next character after the extracted string.  May be null
			if not needed.
	output_string	buffer to copy extracted string to (It must be long
			enough to hold the extracted string plus a null
			terminator.)
	line_length	maximum number of characters per line
	[max_return]	maximum number of characters to return which
			should be less than or equal to "line_length"
			("output_string" must be able to hold "max_return"
			 characters plus a null terminator.)
			(default is "line_length")

	This function returns status values as follows:

	CBS_INVARG		invalid number of characters
	otherwise		number of characters extracted

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_num_lines_c, str_line_info_c, str_get_value_c, strtok,
	str_build_text_block_c

	C/C++ usage:

	char	source_buffer[512];
	char	output_string[81];
	int	offset;
	int	status;
	int	line_length = 80;
	int	max_return = 80;


	status = str_extract_line_c(source_buffer,&offset,output_string,
				    line_length,max_return);