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.
Returns
tline- Type
Any- Description
- Next 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
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);
lineExpected output:
line = RunMatRead 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);
countExpected output:
count = 2Distinguish 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
thirdRead a final line without a newline
fid = fopen('final.txt', 'r');
assert(fid >= 3);
first = fgetl(fid);
second = fgetl(fid);
status = fclose(fid);
first
secondUsing 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
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
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
Import
Json
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.