file_num_lines

	status.i4.v = file_num_lines(file_name.i1a.r, num_lines.i4.r
				     [,search_string.i1a.r]
				     [,start_string.i1a.r]
				     [,term_string.i1a.r])

	This routine returns the number of lines in an ASCII text file.

	file_name	null-terminated string specifing the file
	num_lines	returned number of lines
	[search_string]	string to search for  (If this argument is supplied,
			the number of lines containing this string will
			be returned.)
			(default is NULL)
	[start_string]	start string  (If this argument is supplied
			and the string exists in the file text, the line
			count will start after this string is found.)
			(default is NULL)
	[term_string]	termination string  (If this argument is supplied
			and the string exists in the file text, the line
			count will end when this string is found.)
			(default is NULL)

	This function returns status values as follows:

	OK			success
	CLIB_NOTOPN		couldn't open file

	This function requires the following include files:

	cnsparam_h, cbslib_h, macro_h, acnet_errors_h

	Related functions:

	file_exists_c, file_view_read, file_name_expand_c, file_find_in_path_c,
	file_view_select, file_view_find, file_decide_c, file_acknowledge_c

	C/C++ usage:

	static const char	file_name[] = "/some_path/file_name.ext";
	char	*search_string = (char *) NULL;
	char	*start_string = (char *) NULL;
	char	*term_string = (char *) NULL;
	int	status;
	int	num_lines;

	status = file_num_lines(file_name,&num_lines,search_string,start_string,
				term_string);