mgetl

Arguments

file_desc

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

m

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

txt

a column vector of string

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 sequentialy 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 occured using the meof function) issued.

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

mgetl supports only UTF-8(NO-BOM) 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 an ascii file
• mclose — close an opened file
• mfscanf — reads input from the standard input (interface to the C scanf function)
• mget — reads byte or word in a given binary format and convert to double
• mput — writes byte or word in a given binary format
• mgetstr — read a character string from a file
• mopen — open a file
• read — matrices read

Authors

S. Steer