IDebugExpressionEvaluator::Parse

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

This method converts an expression string to a parsed expression.

Syntax

HRESULT Parse( 
   LPCOLESTR                upstrExpression,
   PARSEFLAGS               dwFlags,
   UINT                     nRadix,
   BSTR*                    pbstrError,
   UINT*                    pichError,
   IDebugParsedExpression** ppParsedExpression
);
int Parse(
   string                     upstrExpression,
   enum_PARSEFLAGS            dwFlags,
   uint                       nRadix,
   out string                 pbstrError,
   out uint                   pichError,
   out IDebugParsedExpression ppParsedExpression
);

Parameters

upstrExpression
[in] The expression string to be parsed.

dwFlags
[in] A collection of PARSEFLAGS constants that determine how the expression is to be parsed.

nRadix
[in] Radix to be used to interpret any numerical information.

pbstrError
[out] Returns the error as human-readable text.

pichError
[out] Returns the character position of the start of the error in the expression string.

ppParsedExpression
[out] Returns the parsed expression in an IDebugParsedExpression object.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

This method produces a parsed expression, not an actual value. A parsed expression is ready to be evaluated, that is, converted to a value.

See also