# mgetl

считывает строки из текстового файла

## Последовательность вызова

    txt = mgetl(file_desc [,m])

## Аргументы

file_desc

  символьная строка, указывающая имя файла или логический блок, возвращаемый функцией `mopen`.

m

  целочисленный скаляр: количество строк, которое нужно прочитать. Значение по умолчанию равно -1.

txt

  вектор-столбец строковых значений.

## Описание

Функция `mgetl` позволяет считывать строки из текстового файла.

Если `m` не указано или равно `-1`, то будут считываться все строки до тех пор, пока не встретится конец файла.

Если `m` указано, то функция `mgetl` пытается прочитать точно `m` строк. Эта опция полезна для последовательного чтения части файла. В этом случае, если конец файла встретится прежде, чем будет прочитано `m` строк, то прочитанные строки будут возвращены оформленными (можно проверять встретился ли конец файла используя функцию `meof`).

Функция `mgetl` позволяет считывать файлы в операционных системах Unix, Windows или Mac.

Функция `mgetl` поддерживает лишь кодировки UTF-8 и ANSI.

## Примеры

    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)

## Смотрите также

- mputl
- mclose
- mfscanf
- mget
- mput
- mgetstr
- mopen
- read