cpiElementValueValue

목적

지정된 구문 요소로부터 값 오브젝트를 가져옵니다. 이 값 오브젝트는 볼 수 없다는 점에서 불투명합니다. 이 오브젝트를 사용하면 cpiSetElementValueValue 함수를 통해 유형을 모르고도 한 요소의 값을 다른 요소 값으로부터 도출하거나 설정할 수 있습니다. 구현 함수 cpiElementValuecpiSetElementValue를 호출하여 작동을 대체하는 구문 분석기가 이 오브젝트를 사용할 수 있습니다.

구문

const CciElementValue* cpiElementValueValue(
    int*                   returnCode,
    CciElement*    targetElement);

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
대상 구문 요소 오브젝트의 주소를 지정합니다(입력).

리턴 값

지정된 대상 구문 요소에 저장된 CciElementValue 오브젝트의 주소가 리턴됩니다. 오류가 발생하면, 0(CCI_NULL_ADDR)이 리턴되고 returnCode는 오류의 이유를 표시합니다.

샘플

다음 예는 샘플 구문 분석기 파일 BipSampPluginParser.c에서 발췌한 것입니다(705 - 725행).

const CciElementValue* cpiElementValue(
    CciParser*      parser,
    CciElement* element
){
    CciElement* firstChild;
    const CciElementValue* value;
    int                rc;

    if ((cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_VALUE) ||
            (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME_VALUE)) {
        value = cpiElementValueValue(&rc, element);
  }
    else if (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME) {
        firstChild = cniFirstChild(&rc, element);
        value = cpiElementValueValue(&rc, firstChild);
  }
  else {
  }

    return(value);
}
관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 태스크
C로 구문 분석기 작성
관련 참조
cpiElementName
cpiElementType
cpiElementValue 그룹
C 구문 분석기 유틸리티 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08460_