NAME

fstrstr -- find string in file

PROTOTYPE

int fstrstr(FILE *fp, char *tStr)

ARGUMENTS

FILE *fp
initial search position in file
char *tStr
pointer to search string
RETURN VALUE:
nr of chars read (=0, if string was not found)

DESCRIPTION:

Searches for next occurrence of string tStr in a file. Starting position of search is specified by file pointer fp. Returns with fp positioned on the first character that follows the detected instance of tStr in the file. If tStr is not in the file, fp will be unchanged. In both cases, the return value will equal the number of bytes fp was moved forward. Unless the first character of the search string tStr is a '#', comments in the file (delimited by '#' and '\\n') are excluded from the search. To include comments in the search, set tStr to the desired search pattern prefixed by the character '#'.

FILE

/amnt/loge/users/nistaff02/nistaff/rhaschke/nst7/man/../o.linux//../nstsrc/nst_aux2.c