FCreate Function (String, DWord) |  |
Create a file or open and truncate an existing file.
Namespace: XSharp.Core
Assembly: XSharp.Core (in XSharp.Core.dll) Version: 2.19
SyntaxRequest Example
View Source
The DOS file handle number of the new file.
If an error occurs, FCreate() returns F_ERROR. FError() can be used to determine the specific error.
Parameters
- cFileName
- Type: String
The name of the file to create, including an optional drive, directory, and extension. SetDefault() and SetPath() settings are ignored; the Windows default is used unless you specify a drive and directory as part of the file name. No extension is assumed.
If the file already exists, its length is truncated to 0 without warning.
This function sets NetErr() in case of a concurrency control conflict. - kAttributes
- Type: DWord
One of the following constants indicating the attribute to be set when creating the file:Constant Description FC_ARCHIVED Archived file FC_HIDDEN Hidden file FC_NORMAL Normal read/write file FC_READONLY Read-only file FC_SYSTEM System file
Return Value
Type: IntPtrThe DOS file handle number of the new file.
If an error occurs, FCreate() returns F_ERROR. FError() can be used to determine the specific error.
Remarks
FCreate() is a low-level file function that either creates a new file or opens an existing file and truncates it to 0 length.
If cFileName does not exist, it is created and opened for writing.
If it does exist and can be opened for writing, it is truncated to 0 length. When FCreate() successfully creates a new file, the file is left open in compatibility sharing mode and read/write access mode.
The file attribute specified by nAttribute is applied to the new file when it is closed, allowing you to write to a newly created read-only file.
For a list of access modes, see FOpen(). Since a file handle is required in order to identify an open file to other file functions, always assign the return value from FCreate() to a variable for later use.
If cFileName does not exist, it is created and opened for writing.
If it does exist and can be opened for writing, it is truncated to 0 length. When FCreate() successfully creates a new file, the file is left open in compatibility sharing mode and read/write access mode.
The file attribute specified by nAttribute is applied to the new file when it is closed, allowing you to write to a newly created read-only file.
For a list of access modes, see FOpen(). Since a file handle is required in order to identify an open file to other file functions, always assign the return value from FCreate() to a variable for later use.
Examples
This example creates a file called TESTFILE and opens it for reading and writing:
X#
1IF (ptrHandle := FCreate("testfile")) = F_ERROR 2 ? DOSErrString(FError()) 3ELSE 4 FWrite(ptrHandle, "Hello there") 5 FClose(ptrHandle) 6ENDIF
See Also