file_length - return the line count of a file

int file_length(string);

returns

- line count
- -1 in case of error (e.g insufficient privs)
- -2 if file is directory

file_size(3)