cpiElementValue 그룹

목적

지정된 구문 요소의 값을 가져오기 위한 함수

구문

CciSize cpiElementBitArrayValue(
  int*            returnCode,
  CciElement*  targetElement,
  const struct CciBitArray* value);
CciBool cpiElementBooleanValue(
  int*            returnCode,
  CciElement*  targetElement);
CciSize cpiElementByteArrayValue(
  int*            returnCode,
  CciElement*  targetElement,
  const struct CciByteArray* value);
CciSize cpiElementCharacterValue(
  int*            returnCode,
  CciElement*  targetElement,
  const CciChar*  value,
  CciSize         length);
struct CciDate cpiElementDateValue(
  int*            returnCode,
  CciElement*  targetElement);
CciSize cpiElementDecimalValue(
  int*            returnCode,
  CciElement*  targetElement,
  const CciChar*  value,
  CciSize         length);
struct CciTimestamp cpiElementGmtTimestampValue(
  int*            returnCode,
  CciElement*  targetElement);
struct CciTime cpiElementGmtTimeValue(
  int*            returnCode,
  CciElement*  targetElement);
CciInt cpiElementIntegerValue(
  int*            returnCode,
  CciElement*  targetElement);
CciReal cpiElementRealValue(
  int*            returnCode,
  CciElement*  targetElement);
struct CciTimestamp cpiElementTimestampValue(
  int*            returnCode,
  CciElement*  targetElement);
struct CciTime cpiElementTimeValue(
  int*            returnCode,
  CciElement*  targetElement);

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
대상 구문 요소 오브젝트의 주소를 지정합니다(입력).
value
구문 요소 값이 저장될 출력 버퍼 주소(입력). 관련 함수 호출에만 사용됩니다.
length
value 매개변수에 지정된 문자 관련 함수 호출에만 사용됩니다.

리턴 값

요소 값이 리턴됩니다.

예를 들면, cpiElementCharacterValue 또는 cpiElementDecimalValue의 경우, 버퍼가 데이터를 수신할 만큼 충분히 크지 않을 경우 데이터는 버퍼에 기록되지 않습니다. 필수 버퍼의 크기는 리턴 값으로 전달되고 returnCode는 CCI_BUFFER_TOO_SMALL로 설정됩니다.

오류가 발생할 경우, returnCode는 오류의 이유를 표시합니다.

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