matlab.io.MatFile.subsasgn — Write one complete variable through a writable MAT-file object.
matlab.io.MatFile.subsasgn(m, S, rhs) is the object protocol behind whole-variable m.A = rhs. The sealed receiver must be writable, and S must designate one valid variable member.
Syntax
m = matlab.io.MatFile.subsasgn(m, S, rhs)Inputs
m- Type
Any- Required
- Yes
- Default
- —
- Description
- Live matlab.io.MatFile object.
S- Type
Any- Required
- Yes
- Default
- —
- Description
- Standard substruct-compatible whole-member path.
rhs- Type
Any- Required
- Yes
- Default
- —
- Description
- Whole variable value.
Returns
m- Type
Any- Description
- Session-bound matlab.io.MatFile compatibility object.
Errors
RunMat:matfile:InvalidArgument- When
- Arguments are not a supported matfile form or the receiver is invalid.
- Message
matfile: invalid argument
RunMat:matfile:InvalidOption- When
- Writable name-value controls are invalid.
- Message
matfile: invalid option
RunMat:matfile:Io- When
- MAT-file data cannot be read or written.
- Message
matfile: MAT-file I/O failure
Whole-member writes
The operation reads existing Level-5 variables through the object's captured provider, gathers resident rhs data from its owner, encodes a replacement MAT file, and writes it through the same captured provider. A same-name variable is replaced; a new name is appended. Read-only or partial assignments reject before publication. The provider write is not a rollback transaction.
Example
Assign a complete MAT variable
m = matfile('assignment.mat', 'Writable', true);
m.A = [5 6];
S = load('assignment.mat')Using matlab.io.MatFile.subsasgn with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how matlab.io.MatFile.subsasgn changes the result.
Run a small matlab.io.MatFile.subsasgn example, explain the result, then change one input and compare the output.
Related Io functions
Mat
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
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 matlab.io.MatFile.subsasgn is executed, line by line, in Rust.
- View the source for matlab.io.MatFile.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.