xHarbour Reference Documentation > Function Reference

FileWriter()

Returns a new TStreamFileWriter object.

Syntax

FileWriter( <cFileName>, [<nFileAttr>] ) --> oTStreamFileWriter

Arguments

<cFilename>

This is a character string holding the name of the file to create and/or write to. It must include path and file extension. If the path is omitted from <cFileName>, the file is created or opened in the current directory.

<nFileAttr>

A numeric value specifying one or more attributes associated with the file to create or open. #define constants from the FILEIO.CH file can be used for <nFileAttr> as listed in the table below:

Attributes for binary file creation

Constant	Value	Attribute	Description
FC_NORMAL *)	0	Normal	Creates a normal read/write file
FC_READONLY	1	Read-only	Creates a read-only file
FC_HIDDEN	2	Hidden	Creates a hidden file
FC_SYSTEM	4	System	Creates a system file
*) default attribute

Return

The function returns a new, initialized TStreamFileWriter object.

Description

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

Info

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