eq — Compare values for element-wise equality.
eq(A,B) and A == B compare compatible operands element by element or construct symbolic equations.
Syntax
tf = eq(A, B)Inputs
A- Type
Any- Required
- Yes
- Description
- Left operand.
B- Type
Any- Required
- Yes
- Description
- Right operand.
Returns
tf- Type
LogicalArray- Description
- Logical equality result, or a symbolic equation for symbolic operands.
Errors
RunMat:eq:InvalidInput- When
- Operands contain unsupported types or mix numeric and text domains.
- Message
eq: mixing numeric and string inputs is not supported
RunMat:eq:SizeMismatch- When
- Operands are not broadcast-compatible.
- Message
eq: array sizes are not compatible for broadcasting
RunMat:gpu:ProviderOwnershipMismatch- When
- Resident operands do not have one exact owning provider.
- Message
eq: resident operands must have one exact owning provider
RunMat:eq:GpuUploadFailed- When
- An explicitly resident logical result cannot be restored to its provider.
- Message
eq: failed to preserve explicit gpuArray residency
Comparison semantics
eq(A,B) and A == B compare corresponding elements after implicit expansion. Numeric, logical, character, string, categorical, complex, and supported object operands follow their domain comparison rules. Complex values are equal only when both components match; NaN is unequal to itself.
All eight fixed-width integer classes compare without first converting authoritative values to double. Character data compares by code point against numeric data and as text against string data. Handle-like values compare by runtime identity rather than structural content.
Symbolic and accelerated execution
A symbolic operand produces a symbolic equation with the broadcast result shape. Ordinary nonsymbolic operands produce logical values.
Compatible resident operands use the exact provider's equality operation when available. Validated results remain resident; unsupported routes use the exact host comparison and restore explicitly requested residency. Compatible elementwise expressions may fuse.
Examples
Compare scalars
tf = eq(42, 42)Expected output:
tf = trueCompare arrays element by element
A = [1 2 3 4];
B = [1 0 3 5];
tf = eq(A, B)Expected output:
tf = [true false true false]Use implicit expansion
A = [1; 2];
B = [1 2 3];
tf = eq(A, B)Expected output:
tf = [true false false; false true false]Compare both complex components
tf = eq([1+2i 1+3i], 1+2i)Expected output:
tf = [true false]Compare character code points
tf = eq(['A' 'B' 'C'], 65)Expected output:
tf = [true false false]Compare string values
names = ["alice" "bob" "alice"];
tf = eq(names, "alice")Expected output:
tf = [true false true]Construct a symbolic equation
syms Y(X)
condition = eq(Y(0), 0)Expected output:
condition = Y(0) == 0Keep an equality result resident
A = gpuArray([1 2 3]);
B = gpuArray([1 0 3]);
gtf = eq(A, B);
tf = gather(gtf)Expected output:
gtf remains a gpuArray and tf = [true false true]Using eq with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how eq changes the result.
Run a small eq example, explain the result, then change one input and compare the output.
FAQ
What class does eq return?⌄
Nonsymbolic comparisons return logical values. Symbolic operands construct symbolic equations.
How does eq compare NaN?⌄
NaN == NaN is false.
How are complex values compared?⌄
Both real and imaginary components must match.
How are handles compared?⌄
Handle-like values compare by identity.
Does implicit expansion apply to strings?⌄
Yes. Compatible string-array shapes expand in the same way as other elementwise comparisons.
Are wide integers rounded?⌄
No. Mixed integer comparisons retain exact fixed-width values.
Does a GPU comparison gather?⌄
A supported same-owner operation stays resident. Exact fallback restores explicitly requested residency.
Related Logical functions
Source you can read
Every RunMat function's source is public. Read exactly how eq is executed, line by line, in Rust.
- View the source for eq 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.