doc/efun/cat

SYNOPSIS
        int cat(string path, int start, int num)

DESCRIPTION
        List the file found at path.

        In most installations it is not legal to have '..' or spaces
        in the path. This commands is normally connected to the "cat"
        command that wizards have. It is also used by the "help"
        command. The optional arguments start and num are start line
        number and number of lines. If they are not given the whole
        file is printed from the beginning.

        The total number of lines will not exceed a system limit, which
        normally is 50 lines.

        cat() returns the number of lines read and printed if success,
        0 if no such file or no lines to read (if start or len is < 0,
        or if the file has less than start lines).

EXAMPLE
        cat("/doc/efun/cat", 5, 9);

        This will print out the file "/doc/efun/cat" begining at line
        5 and ending with line 13.

SEE ALSO
        get_dir(E), file_size(E), read_file(E), read_bytes(E),
        valid_read(M)