islogical — Determine whether a value uses logical storage.
islogical returns one logical scalar that reports whether its input is stored in the logical class.
Syntax
tf = islogical(A)Inputs
A- Type
Any- Required
- Yes
- Description
- Value whose logical storage class is queried.
Returns
tf- Type
LogicalArray- Description
- Logical scalar that is true exactly when the input uses logical storage.
Errors
RunMat:islogical:InternalError- When
- Internal value or resident-handle metadata is contradictory.
- Message
islogical: internal error
RunMat:islogical:TooManyOutputs- When
- More than one output is requested.
- Message
islogical: too many output arguments
Storage class
islogical(A) returns one logical scalar. It is true for logical scalars, logical arrays, and logical sparse matrices, regardless of shape or values. Numeric, character, string, container, object, callable, and symbolic values return false.
The predicate does not convert its input. Use logical(A) when a numeric or sparse value should be converted to logical storage.
Resident values
For a resident value, RunMat validates the exact owner's physical storage and typed class metadata, then returns a host logical scalar without downloading the payload. A logical value stays logical after gather.
Examples
Check a logical scalar
tf = islogical(true)Expected output:
tf = trueCheck a logical array
mask = logical([1 0 1 0]);
tf = islogical(mask)Expected output:
tf = trueDistinguish numeric from logical storage
tf = islogical([1 2 3])Expected output:
tf = falseReject character and string storage
tf_chars = islogical(['R' 'u' 'n']);
tf_string = islogical("RunMat")Expected output:
Both results are falseReject container storage
items = {true, 1};
record = struct("enabled", true);
tf_cell = islogical(items);
tf_struct = islogical(record)Expected output:
Both results are falseInspect a resident logical mask
G = gpuArray([1 2 3]);
mask = G > 1;
tf = islogical(mask);
host_mask = gather(mask)Expected output:
tf = true and host_mask remains logicalUsing islogical with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how islogical changes the result.
Run a small islogical example, explain the result, then change one input and compare the output.
FAQ
Does islogical return an array?⌄
No. It returns one logical scalar describing the input's storage class.
Does it convert numeric values?⌄
No. Use logical for explicit conversion.
Are characters, strings, cells, structs, tables, or objects logical?⌄
No. Only values stored in the logical class return true.
Does a resident query gather the payload?⌄
No. RunMat checks coherent owner and class metadata without downloading element data.
Does a gathered logical gpuArray stay logical?⌄
Yes. Gathering preserves the logical class.
Related Logical functions
Source you can read
Every RunMat function's source is public. Read exactly how islogical is executed, line by line, in Rust.
- View the source for islogical 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.