isvalid — Return whether a handle object or listener is still valid.
isvalid(value) returns a host logical scalar for a handle object or event listener. Non-handle inputs raise RunMat:isvalid:InvalidInput before any resident payload access.
Syntax
tf = isvalid(value)Inputs
value- Type
Any- Required
- Yes
- Default
- —
- Description
- Handle object or event listener.
Returns
tf- Type
LogicalArray- Description
- True when a handle object or listener remains valid.
Errors
RunMat:isvalid:InvalidInput- When
- The input is not a handle object or listener.
- Message
isvalid: input must be a handle object or listener
Behavior and ownership
Handle validity uses the original GC-backed target and deletion state. Deleted handles return false. For handle and listener receivers this sealed query does not dispatch an object method or consult ambient class declarations. Value classes retain ordinary method dispatch. Listener validity requires both live and enabled state; the query does not invoke a callback.
Numeric, text, container, foreign and resident numeric inputs are invalid-domain inputs. The error retains the isvalid owner; resident buffers are not gathered or modified.
The output is a host logical scalar. The query does not launch provider kernels or enter fusion; native and WASM execution use the same runtime path.
Example
Reject a non-handle value
tf = isvalid(42)Using isvalid with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how isvalid changes the result.
Run a small isvalid example, explain the result, then change one input and compare the output.
FAQ
Are numeric arrays valid inputs?⌄
No. This query accepts handle objects and listeners only.
Does isvalid gather GPU arrays?⌄
No. Resident numeric arrays reject from metadata before provider access.
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 · inputname · inputParser · isa · ischar · isdeployed · iskeyword · ismethod · isobject · isstring · isUnderlyingType · 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 isvalid is executed, line by line, in Rust.
- View the source for isvalid 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.