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.
Returns
name- Type
Any- Description
- Caller 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
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.