[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.

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.

## 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.

Documentation generated on: Feb 26 2014