IModelling.Trunc

Syntax

Trunc(Input: Variant; Precision: Variant): Variant;

Parameters

Input. Variable.

Precision. The number of decimal places, to which a number should be truncated.

Description

The Trunc method truncates variable points to the specified number of decimal places.

Comments

Features of setting parameters:

If Precision is greater than 0, the number is rounded to the specified number of decimal places after a decimal point.
If Precision is equal to 0, the number is rounded to the nearest integer.
If Precision is less than 0, the number is rounded to the left of the decimal point.

Example

Executing the example requires that the repository contains a modeling container with the MS identifier. This container includes a model with the MODEL_D identifier that is calculated by the determinate equation method and contains at least one input variable.

Add links to the Metabase and Ms system assemblies.

Sub UserProc;
Var
    Mb: IMetabase;
    ModelSpace, ModelObj:IMetabaseObject;
    Transf: IMsFormulaTransform;
    Formula: IMsFormula;
    Model: IMsModel;
    Determ: IMsDeterministicTransform;
    TransVar: IMsFormulaTransformVariable;
    Slice: IMsFormulaTransformSlice;
    TermInfo: IMsFormulaTermInfo;
    Expr: IExpression;
Begin
    Mb := MetabaseClass.Active;
    ModelSpace := Mb.ItemById("MS").Bind;
    ModelObj := Mb.ItemByIdNamespace("MODEL_D",ModelSpace.Key).Edit;
    Model := ModelObj As IMsModel;
    Transf := Model.Transform;
    Formula := Transf.FormulaItem(0);
    Determ := Formula.Method As IMsDeterministicTransform;
    TransVar := Transf.Inputs.Item(0);
    Slice := TransVar.Slices.Item(0);
    TermInfo := Transf.CreateTermInfo;
    TermInfo.Slice := Slice;
    Expr := Determ.Expression;
    Expr.References := "Ms";
    Expr.AsString := "Trunc(" + TermInfo.TermInnerText + ", 2)";
    If Expr.Valid
        Then ModelObj.Save;
        Else Debug.WriteLine(Model is not saved: error in formula);
    End If;
End Sub UserProc;

After executing the example the model will truncate the first input variable points to two decimal places.

Example of Use in Expressions

Expression 1:

Trunc({Brazil|BCA},2)

Result: Brazil|BCA factor observations are truncated to two decimal places.

Use: it can be used in formulas of cross functional expression editor in any platform tool where it is available.

Expression 2:

Trunc(X1,0)

Result: X1 factor points are truncated to the nearest integer.

Use: it can be used in model formulas of modeling container.

Expression 3:

Trunc(5.978,1)

Result: 5,9.

Application: it can be used in any expressions.