A
          / \      _             Play Now                         Nemesis on 
          | |     | |  _______   _        _   _______    _______   _    _______
          | |\    | | |   ____| |  \    /  | |   ____|  /   ____| | |  /   ____|
 /-------/-------------------------------------------------------------------,
O= Home <=XX|  About  News  Pics  Adventurers  Wizards  Download  Connect     >
 \-------\-------------------------------------------------------------------'
          | |   \   | |  |____  | |      | | |  |____   ___ \  \  | |  ___ \  \
          | |     \_| |_______| |_|      |_| |_______| |_______/  |_| |_______/
          \ /
           V  

Documentation Area

Document Path: /doc/efun/cat

Name: cat - list a file

Syntax:
	int cat(string path, int start, int num)

Description:
	The cat efun lists a file or parts of a file to a player. It is not
	legal to have '.' or spaces in the path. This commands is connected
	to the 'cat' wizard command.

	The optional arguments 'start' and 'num' are the start line number,
	and number of lines to be displayed. If they are not given, the whole
	file is printed from the beginning. The total number lines will not
	exceed a system limit, which is 50 lines.

Return value:
	It returns 1 if successful, 0 if no such file or no such lines.

Examples:
	cat("/text/hints");

See also:
player/more
lib/ls
efun/file_size