다음을 통해 공유

IDebugExpressionContext2::ParseText

  • 아티클

나중에 계산을 위해 식을 텍스트 형식으로 구문 분석합니다.

구문

int ParseText(
    string                pszCode,
    enum_PARSEFLAGS       dwFlags,
    uint                  nRadix,
    out IDebugExpression2 ppExpr,
    out string            pbstrError,
    out uint              pichError
);

매개 변수

pszCode
[in] 구문 분석할 식입니다.

dwFlags
[in] 구문 분석을 제어하는 PARSEFLAGS 열거형의 플래그 조합입니다.

nRadix
[in] pszCode에서 숫자 정보를 구문 분석하는 데 사용할 기수입니다.

ppExpr
[out] 바인딩 및 계산할 준비가 된 구문 분석된 식을 나타내는 IDebugExpression2 개체를 반환합니다.

pbstrError
[out] 식에 오류가 있는 경우 오류 메시지를 반환합니다.

pichError
[out] 식에 오류가 있는 경우 pszCode에서 오류의 문자 인덱스를 반환합니다.

Return Value

성공하면 S_OK를 반환하고, 실패하면 오류 코드를 반환합니다.

설명

이 메서드가 호출되면 DE(디버그 엔진)는 식을 구문 분석하고 정확성을 검증해야 합니다. 식이 잘못된 경우 pbstrError 및 pichError 매개 변수가 채워질 수 있습니다.

식은 계산하지 않고 구문 분석만 합니다. 나중에 EvaluateSync 또는 EvaluateAsync 메서드 호출이 구문 분석된 식을 계산합니다.

예시

다음 예제에서는 IDebugExpressionContext2 인터페이스를 노출하는 간단한 CEnvBlock 개체에 대해 이 메서드를 구현하는 방법을 보여 줍니다. 이 예제에서는 식을 환경 변수의 이름으로 구문 분석하고 해당 변수에서 값을 검색합니다.

HRESULT CEnvBlock::ParseText(
    LPCOLESTR           pszCode,
    PARSEFLAGS          dwFlags,
    UINT                nRadix,
    IDebugExpression2 **ppExpr,
    BSTR               *pbstrError,
    UINT               *pichError)
{
    HRESULT hr = E_OUTOFMEMORY;
    // Create an integer variable with a value equal to one plus
    // twice the length of the passed expression to be parsed.
    int iAnsiLen      = 2 * (wcslen(pszCode)) + 1;
    // Allocate a character string of the same length.
    char *pszAnsiCode = (char *) malloc(iAnsiLen);

    // Check for successful memory allocation.
    if (pszAnsiCode) {
        // Map the wide-character pszCode string to the new pszAnsiCode character string.
        WideCharToMultiByte(CP_ACP, 0, pszCode, -1, pszAnsiCode, iAnsiLen, NULL, NULL);
        // Check to see if the app can successfully get the environment variable.
        if (GetEnv(pszAnsiCode)) {

            // Create and initialize a CExpression object.
            CComObject<CExpression> *pExpr;
            CComObject<CExpression>::CreateInstance(&pExpr);
            pExpr->Init(pszAnsiCode, this, NULL);

            // Assign the pointer to the new object to the passed argument
            // and AddRef the object.
            *ppExpr = pExpr;
            (*ppExpr)->AddRef();
            hr = S_OK;
        // If the program cannot successfully get the environment variable.
        } else {
            // Set the errror message and return E_FAIL.
            *pbstrError = SysAllocString(L"No such environment variable.");
            hr = E_FAIL;
        }
        // Free the local character string.
        free(pszAnsiCode);
    }
    return hr;
}

참고 항목