display — Display a value with a MATLAB-style variable-name header.
display(X) prints a MATLAB-style display block for X. When the callsite argument is a simple variable name, RunMat uses that name as the header; explicit expression arguments print only their value. For classdef objects, RunMat dispatches a registered display method first, then a registered disp method, before the generic formatter.
Syntax
display(X)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
X | Any | Yes | — | Value to display with a variable-name header. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:display:TooManyInputs | Too many input arguments are passed to display. | display: too many input arguments |
RunMat:display:GatherFailed | Input value cannot be gathered onto the host for rendering. | display: failed to gather value for display |
RunMat:display:TooManyOutputs | An output is requested from display. | display does not return output arguments |
How display works
display(X)printsX = ...for simple variable arguments.- An explicit
display(expr)call prints the expression value without anans =header. - Single-line values are printed on the same line as the header.
- Multi-line values such as matrices, structs, tables, datetime arrays, duration arrays, and N-D pages are printed below the header.
- Objects and handle objects dispatch a registered or inherited
displaymethod first, then an overloadeddispmethod, before generic formatting. displayexposes no output argument, and requesting one is an error.
Does RunMat run display on the GPU?
display performs no provider kernel dispatch and is excluded from fusion planning.
Gather behavior is inherited from the same runtime gather path used by disp.
GPU memory and residency
display is a no-output sink. Provider-resident inputs are gathered to host memory for formatting.
Examples
Display a named variable
A = [1 2; 3 4];
display(A)Expected output:
A =
1 2
3 4Display an expression
display(1 + 2)Expected output:
3Display a string
msg = "ready";
display(msg)Expected output:
msg = readyUsing display with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how display changes the result.
Run a small display example, explain the result, then change one input and compare the output.
FAQ
How is display different from disp?⌄
disp(X) prints only the value. display(X) prints a variable-name header such as X = before the value.
Does display support class-specific output?⌄
Yes. RunMat checks a registered display method first and then an overloaded disp method. The full matlab.mixin.CustomDisplay protocol is not yet modeled.
Does display gather GPU arrays?⌄
Yes. Like disp, display formats on the CPU and gathers provider-resident data through the active acceleration provider.
Related Io functions
Repl Fs
addpath · cd · copyfile · delete · dir · exist · fileattrib · fileparts · fullfile · genpath · getenv · getpref · isenv · isfile · isfolder · ispref · ls · matlabroot · memmapfile · 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 · parquetDatastore · parquetinfo · parquetread · readcell · readmatrix · readtable · readtimetable · spreadsheetImportOptions · writecell · writematrix · writetable · writetimetable · xlsread · xlswrite
Filetext
fclose · feof · fgetl · fgets · fileread · filewrite · fopen · fprintf · fread · frewind · fwrite · readlines · writelines
Import
Json
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how display is executed, line by line, in Rust.
- View the source for display in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 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.