scanfile(1tcl)

scanfile -- scan open file starting from current position

Synopsis

scanfile [-copyfile copyFileId] contexthandle fileId

Description

Scans the file specified by fileId, starting from the current file position, and checks all patterns in the scan context specified by contexthandle against it, executing the match commands corresponding to patterns matched.

If the optional -copyfile argument is specified, the next argument is a file ID to which all lines not matched by any pattern (excluding the default pattern) are to be written.