Scilab Website | Contribute with GitLab | Mailing list archives | ATOMS toolboxes
Scilab Online Help
5.3.3 - English

Change language to:
Français - 日本語 - Português

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

Scilab help >> Files : Input/Output functions > 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

<< mget Files : Input/Output functions mgetstr >>

Copyright (c) 2022-2024 (Dassault Systèmes)
Copyright (c) 2017-2022 (ESI Group)
Copyright (c) 2011-2017 (Scilab Enterprises)
Copyright (c) 1989-2012 (INRIA)
Copyright (c) 1989-2007 (ENPC)
with contributors
Last updated:
Wed Oct 05 12:09:59 CEST 2011