mgetl

Scilab Function
Last update : 25/04/2007

mgetl - read lines from an ascii file

### Calling Sequence

  `txt=mgetl(file_desc [,m])`

### Parameters

- `file_desc` :a character string giving the file name or a logical unit returned by mopen
- `m` : an integer scalar. Default value is -1.
- `txt` : a column vector of string

### Description

`mgetl` function allows to read a lines from an ascii 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.

### Examples

    mgetl('SCI/scilab.star',5)

    mgetl SCI/macros/elem/erf.sci

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

### See Also

`mputl` , `mclose` , `mfscanf` , `mget` , `mgetstr` , `mopen` , `read` ,

### Author

S. Steer