WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

TestCreate
✖
TestCreate

✖
TestCreate[input]

create a TestObject to determine whether input evaluates to True.

✖
TestCreate[input,expected]

create a TestObject to determine whether input evaluates to expected.

✖
TestCreate[input,expected,messages]

create a TestObject that is expected to generate the list of message names messages.

Details and Options

Examples

open allclose all

Basic Examples  (4)Summary of the most common use cases

Create a test that tests whether the input evaluates to True:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-rk6fir
Out[1]=1

Evaluate the test:

In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-wx1fgn
Out[2]=2

Test whether the input evaluates to the expected output:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-etsac
Out[1]=1

When a test fails, it returns an outcome of Failure:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-lo28e0
Out[1]=1

When the input evaluates to the expected output but gives messages, the outcome is MessagesFailure:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-hpzn0o
Out[1]=1

Add the expected message:

In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-lj5alc
Out[2]=2

Scope  (2)Survey of the scope of standard use cases

Basic Uses  (2)

Perform a test and present the results in a Dataset:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-zlgxdz
Out[1]=1

Test if the results of an NIntegrate are numerically equivalent to Integrate by using an absolute tolerance:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-m2i7dm
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-ustp54
Out[2]=2

This can also be done by using the SameTest option:

In[3]:=3
✖
https://wolfram.com/xid/0i1mrluya-8v0agp
In[4]:=4
✖
https://wolfram.com/xid/0i1mrluya-8w4cm1
Out[4]=4

Options  (13)Common values & functionality for each option

MemoryConstraint  (1)

Run a test until a memory limit is exceeded:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-nv2
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-6zt3of
In[3]:=3
✖
https://wolfram.com/xid/0i1mrluya-zq3bp
Out[3]=3

SameTest  (5)

Test whether the input is an integer:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-bu1n63
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-pm0wkg
Out[2]=2

Test if the absolute precision of the input is at least 10-12:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-d1t5j9
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-qprc0q
Out[2]=2

Test if the relative precision is at least 10-5:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-o5vwtb
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-j96va8
Out[2]=2

Test if two expressions are equivalent after simplification:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-wz6o93
Out[1]=1

Use Unevaluated to pass unevaluated expressions to the SameTest function:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-o5dvwt
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-bqh8qy
Out[2]=2

You can use a combination of Function and Echo to print the arguments of the SameTest function:

In[3]:=3
✖
https://wolfram.com/xid/0i1mrluya-le6exj
In[4]:=4
✖
https://wolfram.com/xid/0i1mrluya-o8ac5j
Out[4]=4

TestID  (4)

Add a TestID to the test:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-mmvbp7
Out[1]=1

A TestID can be any expression:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-7ioegy
Out[1]=1

By default, the TestID is a Hash of the test:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-f63lqb
Out[1]=1

The TestID will change if the input of the TestCreate expression is different:

In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-j9n9eu
Out[2]=2

Use CreateUUID to create random identifiers every time:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-w8zbvk
Out[1]=1

TimeConstraint  (1)

Terminate the test if it takes more than one second:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-8cbf5w
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-scpdf7
Out[2]=2

MetaInformation  (2)

Store arbitrary metainformation in the TestObject:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-ukoq4d
Out[1]=1

Access the stored MetaInformation:

In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-oif5iw
Out[2]=2

MetaInformation can be any expression:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-imx9ut
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-kkj6ff
Out[2]=2

Possible Issues  (3)Common pitfalls and unexpected behavior

The expected output is evaluated before comparison with the actual output:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-s7ucms
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-f8ytgp
Out[2]=2

Use Unevaluated to compare expressions before evaluation happens:

In[3]:=3
✖
https://wolfram.com/xid/0i1mrluya-dp6zfq
In[4]:=4
✖
https://wolfram.com/xid/0i1mrluya-sbxbs2
Out[4]=4

Messages generated on evaluation of expected output are not accounted for in the expected messages:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-ntticc
Out[1]=1

If SameTest does not evaluate to True or False, a failure type of "SameTestUnevaluated" is reported:

In[1]:=1
✖
https://wolfram.com/xid/0i1mrluya-qprtig
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0i1mrluya-i22y4x
Out[2]=2
Wolfram Research (2023), TestCreate, Wolfram Language function, https://reference.wolfram.com/language/ref/TestCreate.html.
✖
Wolfram Research (2023), TestCreate, Wolfram Language function, https://reference.wolfram.com/language/ref/TestCreate.html.

Text

Wolfram Research (2023), TestCreate, Wolfram Language function, https://reference.wolfram.com/language/ref/TestCreate.html.

✖
Wolfram Research (2023), TestCreate, Wolfram Language function, https://reference.wolfram.com/language/ref/TestCreate.html.

CMS

Wolfram Language. 2023. "TestCreate." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/TestCreate.html.

✖
Wolfram Language. 2023. "TestCreate." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/TestCreate.html.

APA

Wolfram Language. (2023). TestCreate. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TestCreate.html

✖
Wolfram Language. (2023). TestCreate. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/TestCreate.html

BibTeX

@misc{reference.wolfram_2025_testcreate, author="Wolfram Research", title="{TestCreate}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/TestCreate.html}", note=[Accessed: 21-June-2025 ]}

✖
@misc{reference.wolfram_2025_testcreate, author="Wolfram Research", title="{TestCreate}", year="2023", howpublished="\url{https://reference.wolfram.com/language/ref/TestCreate.html}", note=[Accessed: 21-June-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_testcreate, organization={Wolfram Research}, title={TestCreate}, year={2023}, url={https://reference.wolfram.com/language/ref/TestCreate.html}, note=[Accessed: 21-June-2025 ]}

✖
@online{reference.wolfram_2025_testcreate, organization={Wolfram Research}, title={TestCreate}, year={2023}, url={https://reference.wolfram.com/language/ref/TestCreate.html}, note=[Accessed: 21-June-2025 ]}