System.Assign

From Appmethod Libraries
Jump to: navigation, search

Object Pascal

function Assign(var F: File; FileName: String; [CodePage: Word]): Integer; overload;
function Assign(var F: File; FileName: String; [CodePage: Word]): Integer; overload;
function Assign(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 Assign to initialize a file variable in Object Pascal 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 Object Pascal product. However, for backward compatibility, Assign is still available.

See Also