RunMat
  • Pricing
RunMat
GitHub
GitHub
Sign inTry in browser
DesktopRuntimePhysicsCADAdministrationAgent

Get RunMat updates

New releases, guides and examples.

Product+
  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download
Math+
  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting
Physics+
  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA
Industries+
  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance
Learn+
  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students
Compare+
  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons
Company+
  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms

Product

  • Runtime
  • GPU
  • Parallel
  • Compile
  • Interop and MEX
  • Simulation
  • MCAD
  • ECAD
  • Enterprise
  • AI integrations
  • Pricing
  • Download

Math

  • Signal processing
  • Linear algebra
  • Statistics
  • Curve fitting
  • Differential equations
  • Control systems
  • Optimization
  • Finance
  • Data and tables
  • Plotting

Physics

  • Simulation overview
  • Structural
  • Thermal
  • Electromagnetic
  • Joule heating
  • Thermal stress
  • Acoustics
  • Fluid flow
  • Conjugate heat transfer
  • Fluid–structure
  • What is FEA

Industries

  • Aerospace
  • Automotive and transportation
  • Defense
  • Electronics and semiconductors
  • Energy
  • Industrial machinery
  • Life sciences
  • Quantitative finance

Learn

  • Guides
  • Docs
  • Function reference
  • Language reference
  • Migration guide
  • Changelog
  • MATLAB Online
  • MATLAB AI agent
  • For students

Compare

  • RunMat vs MATLAB
  • RunMat vs Ansys
  • RunMat vs SOLIDWORKS
  • RunMat vs Altium
  • RunMat vs Cadence
  • RunMat vs COMSOL
  • RunMat vs Python
  • RunMat vs Julia
  • RunMat vs Physics AI
  • RunMat vs Octave
  • Benchmarks
  • MATLAB alternatives
  • All comparisons

Company

  • About
  • Blog
  • Contact
  • Source code↗
  • License
  • Privacy
  • Terms
GitHubXLinkedIn

© Dystr, Inc. · RunMat v0.7.1, Nov 17, 2026

RunMat® is a registered trademark of Dystr, Inc. MATLAB® is a registered trademark of The MathWorks, Inc. RunMat is not affiliated with, endorsed by, or sponsored by The MathWorks, Inc.

/
See all docs
Builtin Reference
    • addlistener
    • addParameter
    • addprop
    • assignin
    • builtin
    • cancel
    • class
    • clear
    • clearAllMemoizedCaches
    • clearCache
    • clearvars
    • dbclear
    • dbstack
    • dbstatus
    • dbtype
    • eval
    • evalc
    • evalin
    • feval
    • findprop
    • func2str
    • functions
    • get.p
    • getcallinfo
    • getmethod
    • inputname
    • inputParser
    • isa
    • ischar
    • isdeployed
    • iskeyword
    • ismethod
    • isobject
    • isstring
    • isUnderlyingType
    • isvalid
    • keyboard
    • loadobj
    • localfunctions
    • matlab.metadata.DynamicProperty.delete
    • memoize
    • metaclass
    • mfilename
    • mislocked
    • mlock
    • munlock
    • namelengthmax
    • narginchk
    • nargoutchk
    • new_object
    • notify
    • numArgumentsFromSubscript
    • onCleanup
    • parse
    • saveobj
    • set.p
    • stats
    • str2func
    • subsasgn
    • subsref
    • superclasses
    • underlyingType
    • verLessThan
    • version
    • which
    • who
    • whos

inputname — Return the source variable name of a function input.

inputname(argNumber) inspects the caller expression for a one-based function input index. A simple variable yields a character row; an expression, literal, or indexed value yields an empty 0x0 character array.

Syntax

name = inputname(argNumber)

Inputs

argNumber
Type
NumericScalar
Required
Yes
Default
—
Description
One-based caller argument index.
NameTypeRequiredDefaultDescription
argNumberNumericScalarYes—One-based caller argument index.

Returns

name
Type
Any
Description
Caller variable name, or empty character array when unnamed.
NameTypeDescription
nameAnyCaller variable name, or empty character array when unnamed.

Errors

RunMat:NotEnoughInputs
When
No argument index is provided.
Message
inputname: not enough input arguments
RunMat:TooManyInputs
When
More than one argument index is provided.
Message
inputname: too many input arguments
RunMat:InputnameArgumentInvalid
When
The argument index is not a positive integer scalar.
Message
inputname: argument index must be a positive integer scalar
RunMat:InputnameArgumentExceedsInputs
When
The requested argument number exceeds the caller's input count or no function-input callsite exists.
Message
inputname: argument number exceeds number of function inputs
IdentifierWhenMessage
RunMat:NotEnoughInputsNo argument index is provided.inputname: not enough input arguments
RunMat:TooManyInputsMore than one argument index is provided.inputname: too many input arguments
RunMat:InputnameArgumentInvalidThe argument index is not a positive integer scalar.inputname: argument index must be a positive integer scalar
RunMat:InputnameArgumentExceedsInputsThe requested argument number exceeds the caller's input count or no function-input callsite exists.inputname: argument number exceeds number of function inputs

Caller semantics

The index must be a finite, real, positive integer-valued scalar in one of the documented numeric classes. Logical and resident indices are rejected before provider access.

The runtime reads the function-input callsite's source spans. If a cell or dot indexing expression introduces a comma-separated-list input, that input and subsequent inputs have empty names. A call without function-input callsite metadata raises RunMat:InputnameArgumentExceedsInputs.

The implementation does not yet reproduce MATLAB's stack walk through built-in, MEX, or overloaded indexing frames; this depends on a richer shared caller-metadata contract.

Execution

The query uses Core's current callsite/source catalog and does not invoke an operand callback or gather a resident input. Native and browser runtimes use the same source-span path.

Example

Inspect a named function input

input_value = 7; name = probe_input_name(input_value);

Using inputname with coding agents

Open a RunMat example with live inputs, then ask the agent to explain how inputname changes the result.

Run a small inputname example, explain the result, then change one input and compare the output.

FAQ

What is returned for a literal or expression?⌄

An empty 0x0 character array is returned when the caller argument has no simple variable name.

Related Introspection functions

addlistener · addParameter · addprop · assignin · builtin · cancel · class · clear · clearAllMemoizedCaches · clearCache · clearvars · dbclear · dbstack · dbstatus · dbtype · eval · evalc · evalin · feval · findprop · func2str · functions · get.p · getcallinfo · getmethod · inputParser · isa · ischar · isdeployed · iskeyword · ismethod · isobject · isstring · isUnderlyingType · isvalid · keyboard · loadobj · localfunctions · matlab.metadata.DynamicProperty.delete · memoize · metaclass · mfilename · mislocked · mlock · munlock · namelengthmax · narginchk · nargoutchk · new_object · notify · numArgumentsFromSubscript · onCleanup · parse · saveobj · set.p · stats · str2func · subsasgn · subsref · superclasses · underlyingType · verLessThan · version · which · who · whos

Source you can read

Every RunMat function's source is public. Read exactly how inputname is executed, line by line, in Rust.

  • View the source for inputname 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.

Getting started · Benchmarks · Pricing

Download RunMat

Download RunMat for full performance, or use RunMat in your browser for zero setup.

Download RunMatOpen Sandbox
On this page
  • Syntax
  • Inputs
  • Returns
  • Errors
  • Caller semantics
  • Execution
  • Example
  • Inspect a named function input
  • Using inputname with coding agents
  • FAQ
  • Related Introspection functions
  • Source you can read
  • About RunMat