<spew $files [$offset [$length]]>
spew function reads each file given in
prints it out verbatim. If "
-" (single dash) is given,
the standard input is sent.
Normally the entire file is printed. If an
$offset is given,
printing starts at that offset into the file. Negative offsets apply
from the end of the file. If a
$length is also given, that
many bytes are printed; the default is the rest of the file. Negative
lengths indicate the rest of the file. The
$length arguments are parallel to
$files; if they have
fewer values than
$files the last value is re-used.
spew returns 1 for each value of
$files if successful,
or an empty string if not.
No path checking is done on the given files, so any file on the machine that is readable can be read, even if outside the HTML document tree.
Support for standard input was added in version 2.6.939400000 19991008. The
were added in version 3.0.951100000 20000220.
Reads are unbuffered across calls: repeated small reads of the same file are less efficient than one large read.