matlab.unittest.constraints.IsEqualTo — Construct an equality constraint for a test qualification.
IsEqualTo(expected) retains expected in the constraint's public Expected property. RunMat currently supports this single positional form.
Syntax
constraint = matlab.unittest.constraints.IsEqualTo(expected)Inputs
expected- Type
Any- Required
- Yes
- Default
- —
- Description
- Expected host value, retained without numeric conversion.
Returns
constraint- Type
Any- Description
- A scalar constraint object with its concrete runtime class.
Errors
RunMat:Testing:InvalidConstraint- When
- The constructor receives a missing expected value or unsupported additional arguments.
- Message
IsEqualTo requires exactly one expected value
Supported form
Pass exactly one expected value. The constructor retains its class and storage rather than converting it to double. The returned constraint object is host-resident; an expected value nested inside it can still hold a device or other non-transferable resource. RunMat does not promise worker transferability for that object.
Current comparison limits
MATLAB supports IgnoringCase, IgnoringWhitespace, Using, and Within options; these constructor forms are not implemented in RunMat and return RunMat:Testing:InvalidConstraint. RunMat's current verifyThat/assertThat equality path compares real numeric values with their class, shape, and exact integer payload intact, including NaNs. It remains a subset of MATLAB's comparator behavior for other value kinds: it does not invoke user-defined comparators or tolerance objects. Use verifyEqual for the separate qualification contract. The constraint is currently value-backed; no shared handle identity is promised.
Examples
Retain an expected value in an equality constraint
constraint = matlab.unittest.constraints.IsEqualTo(uint64(42));Unsupported comparison options fail during construction
matlab.unittest.constraints.IsEqualTo('A', 'IgnoringCase', true);Using matlab.unittest.constraints.IsEqualTo with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how matlab.unittest.constraints.IsEqualTo changes the result.
Run a small matlab.unittest.constraints.IsEqualTo example, explain the result, then change one input and compare the output.
Related Testing functions
Testing
functiontests · matlab.unittest.TestCase · matlab.unittest.TestRunner.addPlugin · matlab.unittest.TestRunner.run · matlab.unittest.TestRunner.withTextOutput · testsuite
Fixtures
matlab.unittest.fixtures.PathFixture · matlab.unittest.fixtures.TemporaryFolderFixture · matlab.unittest.TestCase.addTeardown · matlab.unittest.TestCase.applyFixture
Plugins
matlab.unittest.plugins.CodeCoveragePlugin.forFolder · matlab.unittest.plugins.TestRunnerPlugin
Qualifications
matlab.unittest.TestCase.assertEqual · matlab.unittest.TestCase.assertThat · matlab.unittest.TestCase.assertTrue · matlab.unittest.TestCase.assumeEqual · matlab.unittest.TestCase.assumeTrue · matlab.unittest.TestCase.fatalAssertTrue · matlab.unittest.TestCase.verifyEmpty · matlab.unittest.TestCase.verifyEqual · matlab.unittest.TestCase.verifyFalse · matlab.unittest.TestCase.verifyGreaterThan · matlab.unittest.TestCase.verifyLessThan · matlab.unittest.TestCase.verifyNotEmpty · matlab.unittest.TestCase.verifyNotEqual · matlab.unittest.TestCase.verifyThat · matlab.unittest.TestCase.verifyTrue
Source you can read
Every RunMat function's source is public. Read exactly how matlab.unittest.constraints.IsEqualTo is executed, line by line, in Rust.
- View the source for matlab.unittest.constraints.IsEqualTo 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.