C++ Syntax

bool

MKI_ConvertStringArea(

double& f_rValue,

const LPCWSTR f_pszText );

Converts a string's content into an area 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

f_rValue

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

f_pszText

[const LPCWSTR] Text containing the area 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.