cpiBufferByte

목적

지정된 구문 분석기 오브젝트에 대한 입력 메시지의 비트스트림 표현이 들어 있는 버퍼로부터 1바이트를 가져옵니다. 색인 인수 값은 바이트 배열 중 어떤 바이트가 리턴되는지 나타냅니다.

구문

CciByte cpiBufferByte(
    int*                   returnCode,
    CciParser*      parser,
    CciSize     index);

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_PARSER_OBJECT
  • CCI_NO_BUFFER_EXISTS
parser
구문 분석기 오브젝트의 주소를 지정합니다(입력).
index
색인으로 사용할 오프셋을 버퍼에 지정합니다(입력).

리턴 값

요청된 바이트가 리턴됩니다. 오류가 발생할 경우, returnCode는 오류의 이유를 표시합니다.

샘플

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

void advance(
    PARSER_CONTEXT_ST* context,
    CciParser*         parser
){
    int rc = 0;

    /* Advance to the next character */
  context->iIndex++;

    /* Detect and handle the end condition */
  if (context->iIndex == context->iSize) return;

    /* Obtain the next character from the buffer */
  context->iCurrentCharacter = cpiBufferByte(&rc, parser, context->iIndex);
}
관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 태스크
C로 구문 분석기 작성
관련 참조
cpiAppendToBuffer
cpiBufferPointer
cpiBufferSize
C 구문 분석기 유틸리티 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08270_