C++ Syntax

bool

MKI_ConvertStringLength(

double& f_rValue,

const LPCWSTR f_pszText );

Converts a string's content into a length value, with terms like (0.5+2.0)/3 being evaluated. This command does NOT try to resolve variables, statements or special constants! To do so manually, call either MKI_ConvertVariables or MKI_ConvertVariablesEx in advance.

Parameters

Value

[double&] Address of variable to receive the evaluated length value.

Text

[const LPCWSTR] Text containing the length value to be converted. This text may either include a single numeric value or a complete term like (0.5+2.0)/3. For a description of the term syntax see Mathematical Terms.

Return Value

Returns true if successful, false if not.

Comment

This procedure will allow a value range of MKI_COORD_MIN (-1e100) to MKI_COORD_MAX (1e100). The default units are the currently active units for lengths and angles.

The term evaluation is limited to 25 bracket levels and 250 elements per bracket level. For more complex calculations, use the slower MKI_ConvertStringLength instead.