RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • fclose
    • feof
    • fgetl
    • fgets
    • fileread
    • filewrite
    • fopen
    • fprintf
    • fread
    • frewind
    • fwrite
    • readlines
    • writelines

fgetl — Read a text line without its newline characters.

fgetl(fid) reads the next line from an open readable file, removes its trailing line terminator, and returns a character row. A read attempted at end-of-file returns double -1; a blank line remains an empty character row.

Syntax

tline = fgetl(fid)

Inputs

fid
Type
NumericScalar
Required
Yes
Description
File identifier opened by fopen.
NameTypeRequiredDefaultDescription
fidNumericScalarYes—File identifier opened by fopen.

Returns

tline
Type
Any
Description
Next line without terminator, or -1 at end-of-file.
NameTypeDescription
tlineAnyNext line without terminator, or -1 at end-of-file.

Errors

RunMat:fgetl:InvalidInput
When
Input argument count or identifier form is invalid.
Message
fgetl: invalid input arguments
RunMat:fgetl:InvalidIdentifier
When
Identifier does not refer to a readable open file.
Message
fgetl: invalid file identifier. Use fopen to generate a valid file ID.
RunMat:fgetl:IoFailure
When
Line read or decode fails.
Message
fgetl: file I/O failed
—
When
Internal control-flow conversion failed.
Message
fgetl: internal error
IdentifierWhenMessage
RunMat:fgetl:InvalidInputInput argument count or identifier form is invalid.fgetl: invalid input arguments
RunMat:fgetl:InvalidIdentifierIdentifier does not refer to a readable open file.fgetl: invalid file identifier. Use fopen to generate a valid file ID.
RunMat:fgetl:IoFailureLine read or decode fails.fgetl: file I/O failed
—Internal control-flow conversion failed.fgetl: internal error

Reading and EOF

A successful read advances the shared file cursor. CR, LF, and paired CRLF or LFCR terminators are removed from the returned row; a final line without a terminator remains readable. An empty line is an empty character row, not the numeric -1 sentinel.

The compatible input is a finite integer-valued double scalar identifier from fopen. Typed integer, Single, and provider-resident numeric scalar identifiers have separate RunMat extension gates. Standard input/output identifiers are not supported for fgetl; a closed, unreadable, or invalid file identifier errors.

At EOF, a read attempt returns double -1 and sets the registry EOF flag queried by feof; frewind clears the flag. Extra requested outputs follow the runtime's legacy double-zero padding. fgets differs by retaining the line terminator and optionally reporting its byte values.

Placement and filesystem

The file handle, cursor, and returned text are host-owned. There is no GPU kernel or fusion path. An admitted resident scalar identifier is gathered before host registry lookup; the original provider allocation remains owned by its caller.

The installed filesystem service must support the open file. Browser filesystem access depends on an installed browser file service and its permissions; the examples use isolated fixture files rather than an ambient browser login.

Examples

Read the first line without a newline

fid = fopen('lines.txt', 'r');
assert(fid >= 3);
line = fgetl(fid);
status = fclose(fid);
line

Expected output:

line = RunMat

Read lines until the EOF sentinel

fid = fopen('twolines.txt', 'r');
assert(fid >= 3);
count = 0;
line = fgetl(fid);
while ischar(line)
    count = count + 1;
    line = fgetl(fid);
end
status = fclose(fid);
count

Expected output:

count = 2

Distinguish an empty line from EOF

fid = fopen('emptyline.txt', 'r');
assert(fid >= 3);
first = fgetl(fid);
second = fgetl(fid);
third = fgetl(fid);
status = fclose(fid);
first
second
third

Read a final line without a newline

fid = fopen('final.txt', 'r');
assert(fid >= 3);
first = fgetl(fid);
second = fgetl(fid);
status = fclose(fid);
first
second

Using fgetl with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how fgetl changes the result.

Run a small fgetl example, explain the result, then change one input and compare the output.

FAQ

What does fgetl return at EOF?⌄

Double -1 after a read attempt at the end; an empty line is an empty character row.

How does it differ from fgets?⌄

fgetl strips the line terminator, while fgets retains it and can return terminator byte values.

What happens for a blank line?⌄

It returns an empty character row and advances past that line; this is distinct from numeric -1.

Can it read from a write-only file?⌄

No. The identifier must refer to a readable open file.

Related Io functions

Filetext

fclose · feof · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines

Net

accept · read · readline · tcpclient · tcpserver · write

Repl Fs

addpath · cd · copyfile · delete · dir · exist · fileattrib · fileparts · filesep · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · memmapfile.subsasgn · memmapfile.subsref · mkdir · movefile · open · opentoline · path · pathsep · pcode · pwd · readstruct · rehash · restoredefaultpath · rmdir · rmpath · run · savepath · setenv · setpref · system · tempdir · tempname · uigetdir · uigetfile · uiputfile · unsetenv · userpath · what · winqueryreg · xmlread · xmlwrite

Tabular

arrayDatastore · csvread · csvwrite · detectImportOptions · dlmread · dlmwrite · fileDatastore · getvaropts · parquetDatastore · parquetinfo · parquetread · readcell · readmatrix · readtable · readtimetable · setvaropts · setvartype · spreadsheetImportOptions · writecell · writematrix · writetable · writetimetable · xlsread · xlswrite

Audio

audioinfo · audioread

Io

clc · diary · disp · display · format · input

Data

commit · data.copy · data.create · data.delete · data.exists · data.export · data.import · data.inspect · data.list · data.move · data.open · DataArray.chunk_shape · DataArray.codec · DataArray.dtype · DataArray.fill · DataArray.name · DataArray.rank · DataArray.read · DataArray.resize · DataArray.shape · DataArray.write · Dataset.array · Dataset.arrays · Dataset.attrs · Dataset.begin · Dataset.get_attr · Dataset.has_array · Dataset.id · Dataset.path · Dataset.refresh · Dataset.set_attr · Dataset.set_attrs · Dataset.snapshot · Dataset.version · DataTransaction.abort · DataTransaction.commit · DataTransaction.create_array · DataTransaction.delete_array · DataTransaction.fill · DataTransaction.id · DataTransaction.resize · DataTransaction.set_attr · DataTransaction.set_attrs · DataTransaction.status · DataTransaction.write

Archive

gunzip · gzip · unzip

Hdf5

h5disp · h5info · h5read · h5write · h5writeatt · hdf5info · hdf5read · hdf5write

Import

importdata · textscan

Json

jsondecode · jsonencode

Mat

load · matfile · matlab.io.MatFile.subsasgn · matlab.io.MatFile.subsref · save

Http

sendmail · urldecode · urlencode · weboptions · webread · websave · webwrite

Source you can read

Every RunMat function's source is public. Read exactly how fgetl is executed, line by line, in Rust.

  • View the source for fgetl in Rust on GitHub
  • Learn how the RunMat runtime works
  • Found a bug? Open an issue with a minimal reproduction.

About RunMat

RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.

  • RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
  • Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Reading and EOF
  • Placement and filesystem
  • Examples
  • Read the first line without a newline
  • Read lines until the EOF sentinel
  • Distinguish an empty line from EOF
  • Read a final line without a newline
  • Using fgetl with coding agents
  • FAQ
  • Related Io functions
  • Filetext
  • Net
  • Repl Fs
  • Tabular
  • Audio
  • Io
  • Data
  • Archive
  • Hdf5
  • Import
  • Json
  • Mat
  • Http
  • Source you can read
  • About RunMat