WOLFRAM

Wolfram Language & System Documentation Center
Wolfram Language Home Page »

InertExpression
✖
InertExpression

[Experimental]

✖

creates an inert expression in compiled code.

Details

Examples

open allclose all

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

Compile a program that returns an expression:

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

Run the program:

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

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

Inert expressions can be manipulated without being evaluated:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-5cvmqz
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-5uhmly
Out[2]=2

Construct an inert expression, wrapping it in Hold before returning from compiled code:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-fsxqav
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-scc11p
Out[2]=2

By default, inert expressions are not evaluated:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-pnvkiu
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-y4cjf0
Out[2]=2

InertEvaluate can be used to request evaluation:

In[3]:=3
✖
https://wolfram.com/xid/0g7heef4osy-5e28eb
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0g7heef4osy-c6vvkg
Out[4]=4

Inert expressions are automatically converted to expressions and evaluated when returned from compiled code:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-0c6d6g
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-s21uny
Out[2]=2

Properties & Relations  (1)Properties of the function, and connections to other functions

Inert expressions can be evaluated with InertEvaluate:

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

Possible Issues  (3)Common pitfalls and unexpected behavior

InertExpression only works in compiled code:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-6iq55i
Out[1]=1

Inert expressions may evaluate when returned from compiled code:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-07sfzq
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-cncwfx
Out[2]=2

Wrap inert expressions in Hold before returning to prevent them from being evaluated:

In[3]:=3
✖
https://wolfram.com/xid/0g7heef4osy-xe41gh
Out[3]=3
In[4]:=4
✖
https://wolfram.com/xid/0g7heef4osy-opwlxd
Out[4]=4

InertExpression does not take compiler variables into account:

In[1]:=1
✖
https://wolfram.com/xid/0g7heef4osy-vb89nn
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0g7heef4osy-bh34gd
Out[2]=2
Wolfram Research (2022), InertExpression, Wolfram Language function, https://reference.wolfram.com/language/ref/InertExpression.html.
✖
Wolfram Research (2022), InertExpression, Wolfram Language function, https://reference.wolfram.com/language/ref/InertExpression.html.

Text

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

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

CMS

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

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

APA

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

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

BibTeX

@misc{reference.wolfram_2025_inertexpression, author="Wolfram Research", title="{InertExpression}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/InertExpression.html}", note=[Accessed: 25-April-2025 ]}

✖
@misc{reference.wolfram_2025_inertexpression, author="Wolfram Research", title="{InertExpression}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/InertExpression.html}", note=[Accessed: 25-April-2025 ]}

BibLaTeX

@online{reference.wolfram_2025_inertexpression, organization={Wolfram Research}, title={InertExpression}, year={2022}, url={https://reference.wolfram.com/language/ref/InertExpression.html}, note=[Accessed: 25-April-2025 ]}

✖
@online{reference.wolfram_2025_inertexpression, organization={Wolfram Research}, title={InertExpression}, year={2022}, url={https://reference.wolfram.com/language/ref/InertExpression.html}, note=[Accessed: 25-April-2025 ]}