Scilab Home page | Wiki | Bug tracker | Forge | Mailing list archives | ATOMS | File exchange
Please login or create an account
Change language to: English - Português - 日本語

Please note that the recommended version of Scilab is 6.0.0. This page might be outdated.
See the recommended documentation of this function

Aide Scilab >> Entrées/Sorties [fichiers] > mgetl

mgetl

read lines from an text file

Calling Sequence

txt=mgetl(file_desc [,m])

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

Scilab Enterprises
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:11:00 CEST 2011