ischar — Test whether a value is a character array in MATLAB and RunMat.
tf = ischar(x) returns true when x is a character array (char row vector or char matrix) and false otherwise. Distinction from string arrays and other types follows MATLAB semantics.
Syntax
tf = ischar(A)Inputs
A- Type
Any- Required
- Yes
- Description
- Value inspected from metadata without payload conversion.
Returns
tf- Type
LogicalArray- Description
- Scalar logical type-query result.
Behavior
Character vectors such as 'RunMat' and char matrices created with ['A'; 'B'] return true.
Empty char arrays (including '' and char.empty(...)) still count as character arrays.
String scalars, string arrays, cell arrays, numeric values, and logical masks all return false.
gpuArray inputs return false unless they are explicitly stored as char arrays (which RunMat does not currently support), matching MATLAB’s behaviour where gpuArray does not host char data.
The result is always a host logical scalar (logical(0) or logical(1)), so it can be used in branching, masking, or validation code without additional conversions.
GPU and residency
ischar never launches GPU kernels. When you pass a gpuArray value, RunMat inspects the residency metadata and simply reports false because device-resident buffers are numeric or logical. This matches MATLAB’s semantics and avoids unnecessary host↔device transfers.
You usually do NOT need to call gpuArray yourself in RunMat (unlike MATLAB).
In RunMat, the fusion planner keeps residency on GPU in branches of fused expressions. As such, calling ischar on a gpuArray result preserves the device buffer, and ischar answers the query using metadata only.
To preserve backwards compatibility with MathWorks MATLAB, and for when you want to explicitly bootstrap GPU residency, you can call gpuArray explicitly to move data to the GPU if you want to be explicit about the residency.
Since MathWorks MATLAB does not have a fusion planner, and they kept their parallel execution toolbox separate from the core language, as their toolbox is a separate commercial product, MathWorks MATLAB users need to call gpuArray to move data to the GPU manually whereas RunMat users can rely on the fusion planner to keep data on the GPU automatically.
Returns a host logical scalar; GPU inputs are inspected without launching kernels.
Legacy examples and displayed results
Checking if a character vector is a char array
tf = ischar('RunMat')
Expected display: tf = logical(1)
Detecting multi-row char matrices
letters = ['ab'; 'cd'];
tf = ischar(letters)
Expected display: tf = logical(1)
Distinguishing between char arrays and string scalars
tf_char = ischar('hello');
tf_string = ischar("hello")
Expected display: tf_char = logical(1)
tf_string = logical(0)
Recognising that numeric and logical data are not char arrays
numbers = [1 2 3];
mask = true(1, 3);
tf_numbers = ischar(numbers);
tf_mask = ischar(mask)
Expected display: tf_numbers = logical(0)
tf_mask = logical(0)
Testing gpuArray inputs
G = gpuArray(ones(2, 2));
tf_gpu = ischar(G)
Expected display: tf_gpu = logical(0)
Example
Inspect a type with an assertion
tf = ischar('RunMat')Using ischar with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ischar changes the result.
Run a small ischar example, explain the result, then change one input and compare the output.
FAQ
Does ischar treat empty character arrays as char?⌄
Yes. Both '' and arrays created with char.empty return logical(1) because they are still character arrays, even when they have zero elements.
Why does ischar return false for string scalars?⌄
Strings in MATLAB are a distinct type introduced in R2016b. They are not interchangeable with char arrays, so ischar("text") correctly returns logical(0).
What about cell arrays of characters?⌄
Cell arrays such as {'a', 'b'} return logical(0) because they are cell containers rather than a single char array. Use iscellstr if you need to validate cell-of-char collections.
Can gpuArray hold char data in RunMat?⌄
Not currently. gpuArray values in RunMat contain numeric or logical tensors, so ischar reports false for all gpuArray inputs, mirroring MATLAB’s behaviour.
How do I convert a string to a char array if ischar returns false?⌄
Use char(stringScalar) or the convertStringsToChars utility when you need to operate on char arrays for legacy APIs.
Is there any performance cost when checking large arrays?⌄
No. ischar only inspects the value’s metadata; it does not copy or iterate over the array elements, so the cost is constant regardless of array size.
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 · 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 ischar is executed, line by line, in Rust.
- View the source for ischar 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.