System.AssignFile

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function AssignFile(var F: File; FileName: String; [CodePage: Word]): Integer; overload;
function AssignFile(var F: File; FileName: String; [CodePage: Word]): Integer; overload;
function AssignFile(var F: File; FileName: String; [CodePage: Word]): Integer; overload;

Properties

Type Visibility Source Unit Parent
function public System.pas System System

Description

Associates the name of an external file with a file variable.

Call AssignFile to initialize a file variable in Delphi code. F is a file variable of any file type. FileName is a string-type expression or an expression of type PChar if extended syntax is enabled.

After calling AssignFile, F is associated with the external file until F is closed. All further operations on the file variable F operate on the external file named by FileName.

When the FileName parameter is empty, AssignFile associates F with the standard input or standard output file. If assigned an empty name, after a call to Reset (F), F refers to the standard input file, and after a call to Rewrite (F), F refers to the standard output file.

Do not use AssignFile on a file variable that is already open.

Note: To avoid scope conflicts, AssignFile replaces the Assign procedure that was available in early versions of the Delphi product. However, for backward compatibility, Assign is still available.

See Also


Code Examples