System.Assign

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure Assign(var F: File; FileName: String); overload;
procedure Assign(var F: TextFile; FileName: String); overload;
procedure Assign(var F: TextFile; FileName: String; CodePage: Word); overload;

Properties

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

Description

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

Call Assign 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 Assign, 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, Assign 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 Assign 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