isstruct — Determine whether a value is a structure array.
isstruct returns a logical scalar based on the input's structure-container identity.
Syntax
tf = isstruct(A)Inputs
A- Type
Any- Required
- Yes
- Default
- —
- Description
- Value whose structure-container class is queried.
Returns
tf- Type
LogicalArray- Description
- Logical scalar that is true exactly when the input is a structure array.
Errors
RunMat:isstruct:InternalError- When
- Internal value or resident-handle metadata is contradictory.
- Message
isstruct: internal error
RunMat:isstruct:TooManyOutputs- When
- More than one output is requested.
- Message
isstruct: too many output arguments
Structure-container identity
isstruct(A) returns one logical scalar. It is true for scalar, nonscalar, or empty structure arrays and false for objects, cells, and all other value classes.
The predicate checks the input container, not the types or values of its fields. A structure stored inside a cell does not make the cell itself a structure array.
Execution and placement
The host result is determined from value or distributed-handle type metadata. Numeric and resident payloads are never downloaded or converted.
Examples
Identify a scalar structure
S = struct('temperature', 21); tf = isstruct(S)Expected output:
tf = trueA cell containing a structure is still a cell
C = {struct('temperature', 21)}; tf = isstruct(C)Expected output:
tf = falseAn empty structure array retains its container identity
S = struct([]); tf = isstruct(S)Expected output:
tf = trueUsing isstruct with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how isstruct changes the result.
Run a small isstruct example, explain the result, then change one input and compare the output.
Related Logical functions
Source you can read
Every RunMat function's source is public. Read exactly how isstruct is executed, line by line, in Rust.
- View the source for isstruct 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.