CREATE Function (File)

Creates and opens an ASCII or binary file. If the file exists, it will be truncated and then opened.


[Ok := ] File.CREATE(Name)

Parameters

File

Type: file

Specifies the file.

Name

Type: text or code

The name of the file, including the path. The following rules apply:

  • You can omit the drive designation if the file is located on the current drive.

  • You can omit the full path if the file is located in the current directory.

  • You can enter only the subdirectory name if the file is located in a subdirectory of the current directory.

Type: Boolean

Specifies whether the file was created.

true if the file was created; otherwise, false.

Always call the TEXTMODE Function (File) before you use the CREATE function or the OPEN Function (File).

If TEXTMODE is true and you read or write to the file, text is placed in the buffer.

If TEXTMODE is false, binary information is placed in the buffer.

Differences Between the Classic Client and RoleTailored Client

If you are running the RoleTailored client and you call CREATE on a file variable that refers to an open file, the function will not automatically close the existing file and create the new file. You must explicitly call the CLOSE Function (File) to close the existing file. Otherwise, a run-time error occurs.

If you are running the Classic client and you call CREATE on a file variable that refers to an open file, the function will CLOSE the existing file and CREATE the new file. A run-time error does not occur.

Community Additions

ADD
Show: