mgetl

Arguments

file_desc

a character string giving the file name or an integer giving a logical unit returned by mopen.

m

an integer scalar: a number of lines to read. Default value is -1.

txt

a column vector of strings.

Description

mgetl function allows to read a lines from an text file.

If m is omitted or is -1 all lines till end of file occurs are read.

If m is given mgetl tries to read exactly m lines. This option is useful to sequentially read part of a file. In this case if an end of file (EOF) occurs before m lines are read the read lines are returned (it is possible to check if EOF had occurred using the meof function) issued.

mgetl allows to read files coming from Unix, Windows or Mac operating systems.

mgetl supports only UTF-8 and ANSI file encoding.

Examples

mgetl('SCI/etc/scilab.start',5)

mgetl SCI/modules/elementary_functions/macros/erf.sci

fd=mopen('SCI/etc/scilab.start','r')
mgetl(fd,10)
mclose(fd)

See also

• mputl — writes strings in a text file
• mclose — closes opened files
• mfscanf — reads input from the stream pointer stream (interface to the C fscanf function)
• mget — parses numbers in a binary file and returns them as decimals
• mput — writes byte or word in a given binary format
• mgetstr — reads a character string from a file
• mopen — opens files in Scilab
• read — matrices read