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


Write variable to a text file and append newline


Source position: line 0

procedure Writeln(

  Args: Arguments


procedure WriteLn(

  var F: Text;

  Args: Arguments



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.
Remark: When writing string variables, no codepage conversions are done. The string is copied as-is to the file descriptor. In particular, for console output, it is the programmer's responsibility to make sure that the codepage of the string matches the codepage of the console.


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

See also



Write variable to a text file



Read from a text file into variable



Read from a text file into variable and goto next line



Write data from memory to an untyped file


Program Example75;

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

  F : File of Longint;
  L : Longint;

  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);

Documentation generated on: Mar 14 2014