UnitsManager.evaluateExpression Method

Parent Object: UnitsManager
Defined in namespace "adsk::core" and the header file is <Core/Application/UnitsManager.h>

Description

Gets the value (in internal units) of the expression.

Syntax

"unitsManager_var" is a variable referencing a UnitsManager object.

# Uses no optional arguments.
returnValue = unitsManager_var.evaluateExpression(expression)

# Uses optional arguments.
returnValue = unitsManager_var.evaluateExpression(expression, units)
"unitsManager_var" is a variable referencing a UnitsManager object.

#include <Core/Application/UnitsManager.h>

// Uses no optional arguments.
returnValue = unitsManager_var->evaluateExpression(expression);

// Uses optional arguments.
returnValue = unitsManager_var->evaluateExpression(expression, units);
"unitsManager_var" is a variable referencing a UnitsManager object.

// Uses no optional arguments.
returnValue = unitsManager_var.evaluateExpression(expression);

// Uses Optional arguments.
returnValue = unitsManager_var.evaluateExpression(expression, units);

Return Value

Type Description
double Returns -1 AND GetLastError will return ExpressionError in the event of an error.

Parameters

Name Type Description
expression string EvaluateExpression("1cm + 1in") -> 3.54 EvaluateExpression("1") -> -> depends on the DistanceUnits, with "mm" it gives 0.1
units string If not supplied the units will default to the default length specified in the preferences.

This is an optional argument whose default value is "DefaultDistance".

Samples

Name Description
Use inputBox to get value and evaluateExpression to validate it

Uses UserInterface.inputBox to prompt for a string, then validates the entry with UnitsManager.evaluateExpression.

Before running: Run from Scripts and Add-Ins with a design open. The sample is interactive and waits for input in a dialog.

Version

Introduced in version August 2014