memmapfile.subsasgn — Update controls or selected bytes through a sealed writable memmapfile receiver.
Ordinary assignment to m.Writable, m.Offset, m.Format, m.Repeat, or m.Data invokes memmapfile.subsasgn. Selected Data indexing uses the canonical fixed-shape index plan and writes only affected opened byte ranges. A mapped write may partly commit before a later error; it is not a transaction.
Syntax
m = memmapfile.subsasgn(m, S, rhs)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.
rhs- Type
Any- Required
- Yes
- Default
- —
- Description
- Value matching the selected Format class, shape, and record fields.
Returns
m- Type
Any- Description
- Updated memmapfile receiver; opened backing writes are observable by aliases.
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
Assignment forms
The runtime calls m = memmapfile.subsasgn(m, S, rhs) for property and indexed Data assignment. S is a standard object subscript structure. A writable receiver requires an opened backing from the selected filesystem provider; a detached snapshot is read-only.
Writable, Offset, Repeat, and Format are receiver controls copied independently when the object is cloned. The opened backing remains shared. Repeat accepts a nonnegative count or numeric Inf; Format determines the exact type and record layout.
Data assignment requires the declared numeric or character class and the selected shape. A fixed mapped field or record cannot grow into an adjacent byte range. Selected updates leave other fields and records untouched.
Effects and limits
The receiver's selected provider, opened file identity, and session authority remain captured. A pending resident rhs or index may materialize before file effects; unsupported or invalid geometry rejects before writes.
A multi-chunk update is not atomic. The source of a mapped write error reports whether the current chunk committed bytes or has indeterminate effects, while earlier successful chunks remain committed. Synchronous codec and provider phases may delay cancellation, and large assignments may use substantial host memory.
A malformed standard S reports InvalidObjectSubscriptPath; a well-formed S naming an unsupported mapped property reports the memmapfile format diagnostic.
Example
Write one exact mapped element without replacing other bytes
m = memmapfile('samples.bin', 'Format', {'uint16', [2 1], 'samples'}, 'Writable', true);
m.Data.samples(2) = uint16(7);
n = memmapfile('samples.bin', 'Format', {'uint16', [2 1], 'samples'});
assert(isequal(n.Data.samples, uint16([1; 7])));Using memmapfile.subsasgn with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how memmapfile.subsasgn changes the result.
Run a small memmapfile.subsasgn 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.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
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.subsasgn is executed, line by line, in Rust.
- View the source for memmapfile.subsasgn 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.