FCREATE()

Creates a file.

Syntax

FCREATE( <cFile>, [<nAttribute>] ) --> nHandle

Arguments

<cFile> is the name of the file to create.

<nAttribute> Numeric code for the file attributes.

Returns

<nHandle> Numeric file handle to be used in other operations.

Description

This function creates a new file with a filename of . The default value of is 0 and is used to set the attribute byte for the file being created by this function. The return value will be a file handle that is associated with the new file. This number will be between zero to 65,535, inclusive. If an error occurs, the return value of this function will be -1.

If the file already exists, the existing file will be truncated to a file length of 0 bytes.

If specified, the following table shows the value for and their related meaning to the file being created by this function.

<nAttribute>fileio.chAttribute
0FC_NORMALNormal/Default,Read/Write
1FC_READONLYRead-only file attribute is set
2FC_HIDDENHidden,Excluded from normal DIR search
4FC_SYSTEMCreate,Excluded from normal DIR search

Examples

IF (nh:=FCREATE("TEST.TXT") <0
? "Cannot create file"
ENDIF

Status

Ready

Compliance

This function is CA-Clipper compliant.

Files

Library is rtl Header is fileio.ch

See Also