xHarbour Reference Documentation > Function Reference

FileReader()

Returns a new TStreamFileReader object.

Syntax

FileReader( <cFileName>, [<nMode>] ) --> oTStreamFileReader

Arguments

<cFileName>

This is a character string holding the name of the file to open for reading. It must include path and file extension. If the path is omitted from <cFileName>, the file is searched in the current directory.

<nMode>

A numeric value specifying the open mode and access rights for the file. #define constants from the FILEIO.CH file can be used for <nMode> as listed in the table below:

File open modes

Constant	Value	Description
FO_READ	0	Open file for reading
FO_WRITE	1	Open file for writing
FO_READWRITE *)	2	Open file for reading and writing
*) default

Constants that define the access or file sharing rights can be added to an FO_* constant. They specify how file access is granted to other applications in a network environment.

File sharing modes

Constant	Value	Description
FO_COMPAT *)	0	Compatibility mode
FO_EXCLUSIVE	16	Exclusive use
FO_DENYWRITE	32	Prevent other applications from writing
FO_DENYREAD	48	Prevent other applications from reading
FO_DENYNONE	64	Allow others to read or write
FO_SHARED	64	Same as FO_DENYNONE
*) default

Return

The function returns a new, initialized TStreamFileReader object.

Description

Function TStreamFileReader() is the functional equivalent of TStreamFileReader():new(). Refer to the description of the TStreamFileReader object.

Info

See also:	TStreamFileReader()
Category:	Object functions , xHarbour extensions
Header:	fileio.ch
Source:	rtl\stream.prg
LIB:	lib\xhb.lib
DLL:	dll\xhbdll.dll