지정된 구문 요소로부터 값 오브젝트를 가져옵니다. 이 값 오브젝트는 볼 수 없다는 점에서 불투명합니다. 이 오브젝트를 사용하면 cpiSetElementValueValue 함수를 통해 유형을 모르고도 한 요소의 값을 다른 요소 값으로부터 도출하거나 설정할 수 있습니다. 구현 함수 cpiElementValue 및 cpiSetElementValue를 호출하여 작동을 대체하는 구문 분석기가 이 오브젝트를 사용할 수 있습니다.
const CciElementValue* cpiElementValueValue( int* returnCode, CciElement* 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); }