WOLFRAM

Wolfram Language & System Documentation Center

InertEvaluate[inertExpr]

evaluates an "InertExpression", returning a new "InertExpression" in compiled code.

Details
Details and Options Details and Options
Examples  
Basic Examples  
Properties & Relations  
Possible Issues  
See Also
History
Cite this Page

InertEvaluate

InertEvaluate[inertExpr]

evaluates an "InertExpression", returning a new "InertExpression" in compiled code.

Details

Examples

open all close all

Basic Examples  (1)

Compile a function that evaluates an "InertExpression" before returning its head:

Wolfram Language code: cf = FunctionCompile[Function[{}, Head[InertEvaluate[InertExpression[2 + 2]]]]]
Wolfram Language code: cf[]

Properties & Relations  (1)

Define a function in the Wolfram Engine:

Wolfram Language code: f[x_] := x ^ 2

Call the function from compiled code using InertEvaluate alongside Construct and InertExpression:

Wolfram Language code: cf = FunctionCompile[ Function[Typed[arg, "MachineInteger"], Cast[ InertEvaluate[Construct[InertExpression[f], Cast[arg, "InertExpression"]]], "MachineInteger" ] ] ]
Wolfram Language code: cf[10]

The same result can be accomplished using KernelFunction:

Wolfram Language code: cf1 = FunctionCompile[ Function[Typed[arg, "MachineInteger"], TypeHint[KernelFunction[f], {"MachineInteger"} -> "MachineInteger"][arg] ] ]
Wolfram Language code: cf1[10]

Possible Issues  (1)

Expressions continue to be evaluated after being returned from ReleaseHold:

Wolfram Language code: heldExpr = Hold[x + 2 + 3]; expr = ReleaseHold[heldExpr]
Wolfram Language code: x = 3;
Wolfram Language code: expr
Wolfram Language code: Head[expr]

In contrast, "InertExpression" returned by InertEvaluate continues to be inert:

Wolfram Language code: cf = FunctionCompile[Function[{}, Module[{inertExpr, expr}, inertExpr = InertExpression[y + 2 + 3]; expr = InertEvaluate[inertExpr]; InertEvaluate[InertExpression[y = 3]]; Head[expr] ]]]
Wolfram Language code: cf[]
Wolfram Research (2022), InertEvaluate, Wolfram Language function, https://reference.wolfram.com/language/ref/InertEvaluate.html.

Text

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

CMS

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

APA

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

BibTeX

@misc{reference.wolfram_2026_inertevaluate, author="Wolfram Research", title="{InertEvaluate}", year="2022", howpublished="\url{https://reference.wolfram.com/language/ref/InertEvaluate.html}", note=[Accessed: 12-June-2026]}

BibLaTeX

@online{reference.wolfram_2026_inertevaluate, organization={Wolfram Research}, title={InertEvaluate}, year={2022}, url={https://reference.wolfram.com/language/ref/InertEvaluate.html}, note=[Accessed: 12-June-2026]}