fread_linefread_linefread_lineFreadLineFreadLine (Operator)

Name

fread_linefread_linefread_lineFreadLineFreadLine — Read a line from a text file.

Signature

Description

The operator fread_linefread_linefread_lineFreadLineFreadLine reads a line from the current input file (including the line skip). If the end of the file is reached IsEOFIsEOFIsEOFIsEOFisEOF returns the value 1, otherwise 0.

Attention

The maximum string length is 1024 character (including the end of string character).

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Example (C)

do {
  fread_line(FileHandle,&Line,&IsEOF) ;
} while(IsEOF==0) ;

Result

If the file is open and a suitable line is read fread_linefread_linefread_lineFreadLineFreadLine returns the value 2 (H_MSG_TRUE). Otherwise an exception is raised.

Possible Predecessors

open_fileopen_fileopen_fileOpenFileOpenFile

Possible Successors

close_fileclose_fileclose_fileCloseFileCloseFile

Alternatives

fread_charfread_charfread_charFreadCharFreadChar, fread_stringfread_stringfread_stringFreadStringFreadString

See also

open_fileopen_fileopen_fileOpenFileOpenFile, close_fileclose_fileclose_fileCloseFileCloseFile, fread_charfread_charfread_charFreadCharFreadChar, fread_stringfread_stringfread_stringFreadStringFreadString

Module

Foundation