ne — Compare values for element-wise inequality.
ne(A,B) and A ~= B compare compatible operands element by element or construct symbolic inequalities.
Syntax
tf = ne(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 inequality result, or a symbolic inequality for symbolic operands.
Errors
RunMat:ne:InvalidInput- When
- Operands contain unsupported types or mix numeric and text domains.
- Message
ne: mixing numeric and string inputs is not supported
RunMat:ne:SizeMismatch- When
- Operands are not broadcast-compatible.
- Message
ne: array sizes are not compatible for broadcasting
RunMat:gpu:ProviderOwnershipMismatch- When
- Resident operands do not have one exact owning provider.
- Message
ne: resident operands must have one exact owning provider
RunMat:ne:GpuUploadFailed- When
- An explicitly resident logical result cannot be restored to its provider.
- Message
ne: failed to preserve explicit gpuArray residency
Comparison semantics
ne(A,B) and A ~= B compare corresponding elements after implicit expansion. A complex pair is unequal when either component differs, and every comparison involving NaN is unequal.
Numeric, logical, character, string, categorical, and supported object operands use the same domain rules as equality. Fixed-width integers remain exact, characters compare as code points against numeric values, and handle-like values compare by identity.
Symbolic and accelerated execution
A symbolic operand produces a symbolic inequality with the broadcast result shape. Nonsymbolic comparisons return logical values.
Compatible resident operands use the provider inequality operation when available. Exact fallback restores explicitly requested residency, and compatible expressions may fuse.
Examples
Compare different scalars
tf = ne(42, 7)Expected output:
tf = trueFind unequal elements
tf = ne([1 2 3 4], [1 0 3 5])Expected output:
tf = [false true false true]Use implicit expansion
tf = ne([1; 2], [1 2 3])Expected output:
tf = [false true true; true false true]Compare complex components
tf = ne([1+2i 1+3i], 1+2i)Expected output:
tf = [false true]Compare NaN
tf = ne(NaN, NaN)Expected output:
tf = trueKeep an inequality result resident
A = gpuArray([1 2 3]);
B = gpuArray([0 2 4]);
gtf = ne(A, B);
tf = gather(gtf)Expected output:
gtf remains a gpuArray and tf = [true false true]Using ne with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how ne changes the result.
Run a small ne example, explain the result, then change one input and compare the output.
FAQ
What class does ne return?⌄
Nonsymbolic comparisons return logical values. Symbolic operands construct symbolic inequalities.
How does ne compare NaN?⌄
NaN ~= NaN is true.
How are complex values compared?⌄
A difference in either component makes the result true.
How are handles compared?⌄
Handle-like values compare by identity.
Does implicit expansion apply to strings?⌄
Yes, for compatible string-array shapes.
Are wide integers rounded?⌄
No. Mixed integer comparisons retain exact fixed-width values.
Can ne fuse?⌄
Compatible elementwise regions may fuse on the selected provider.
Related Logical functions
Source you can read
Every RunMat function's source is public. Read exactly how ne is executed, line by line, in Rust.
- View the source for ne 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.