memmapfile.subsref — Read a property or selected bytes from a sealed memmapfile receiver.
Object property and indexed Data access use the memmapfile class's subsref method. Opened-range providers read only selected byte ranges for indexed Data; whole Data returns a decoded host snapshot. A detached read-only receiver indexes its explicit host snapshot.
Syntax
value = memmapfile.subsref(m, S)Inputs
m- Type
Any- Required
- Yes
- Default
- —
- Description
- One sealed memmapfile receiver issued by the selected filesystem provider.
S- Type
Any- Required
- Yes
- Default
- —
- Description
- Standard structure subscript describing a public property or mapped Data selection.
Returns
value- Type
Any- Description
- Host property value or a decoded selection from the opened mapped backing.
Errors
RunMat:memmapfile:TooManyOutputs- When
- More than one result is requested.
- Message
memmapfile: too many output arguments
RunMat:InvalidObjectSubscriptPath- When
- S is not a valid standard object subscript path.
- Message
memmapfile: invalid standard subscript path
RunMat:parallel:Cancelled- When
- The execution service cancels a pending selector, gather, or mapped-range operation.
- Message
memmapfile: mapped operation cancelled
Forms and authority
The runtime calls value = memmapfile.subsref(m, S) for ordinary m.Property and m.Data(indices) syntax. S is a standard object subscript structure; a class name alone does not authorize access without the receiver's sealed state.
Filename, Writable, Offset, Format, and Repeat expose receiver controls. Data is decoded from the opened backing on access, preserving the declared numeric class and exact integer bits. Indexing a field or record uses fixed-size, column-major selection and does not read unrelated mapped bytes.
Execution and limits
The selected filesystem provider and session owner remain captured across suspension. Provider-resident indices may materialize before a mapped read. The result is a host value; no GPU kernel or distributed transfer of the opened file handle is implied.
Whole Data and codec decoding can allocate substantial host memory, and synchronous provider or codec work may delay cancellation. A file extent limits offsets, not host memory use.
A malformed standard S reports InvalidObjectSubscriptPath; a well-formed S naming an unsupported mapped property reports the memmapfile format diagnostic.
Example
Read one exact mapped UInt16 element
m = memmapfile('samples.bin', 'Format', {'uint16', [2 1], 'samples'});
x = m.Data.samples(2);
assert(isequal(x, uint16(2)));
assert(strcmp(class(x), 'uint16'));Using memmapfile.subsref with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how memmapfile.subsref changes the result.
Run a small memmapfile.subsref example, explain the result, then change one input and compare the output.
Related Io functions
Repl Fs
addpath · cd · copyfile · delete · dir · exist · fileattrib · fileparts · filesep · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · memmapfile.subsasgn · 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
Filetext
fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines
Import
Json
Source you can read
Every RunMat function's source is public. Read exactly how memmapfile.subsref is executed, line by line, in Rust.
- View the source for memmapfile.subsref 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.