[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'System' (#rtl)

WriteLn

Write variable to a text file and append newline

Declaration

Source position: line 0

procedure Writeln(

  Args: Arguments

);

procedure WriteLn(

  var F: Text;

  Args: Arguments

);

Description

WriteLn does the same as Write for text files, and emits a Carriage Return - LineFeed character pair after that. If the parameter F is omitted, standard output is assumed. If no variables are specified, a Carriage Return - LineFeed character pair is emitted, resulting in a new line in the file F.

Remark: Under linux and unix, the Carriage Return character is omitted, as customary in Unix environments.

Errors

If an error occurs, a run-time error is generated. This behavior can be controlled with the {$I} switch.

See also

Write

  

Write variable to a text file

Read

  

Read from a text file into variable

Readln

  

Read from a text file into variable and goto next line

Blockwrite

  

Write data from memory to an untyped file

Example

Program Example75;

{ Program to demonstrate the Write(ln) function. }

Var
  F : File of Longint;
  L : Longint;

begin
  Write ('This is on the first line ! '); { No CR/LF pair! }
  Writeln ('And this too...');
  Writeln ('But this is already on the second line...');
  Assign (f,'test.tmp');
  Rewrite (f);
  For L:=1 to 10 do
    write (F,L); { No writeln allowed here ! }
  Close (f);
end.
The latest version of this document can be found at lazarus-ccr.sourceforge.net.