cniSearchElement 그룹

지정된 요소의 이전 동위 요소에서 지정된 기준에 맞는 요소를 검색합니다. 검색은 targetElement 매개변수에 지정된 구문 요소에서 시작되며, 다음 네 함수는 각각 서로 다른 트리 방향으로 검색을 제공합니다.
  1. cniSearchFirstChild는 일치항목이 발견될 때 또는 하위 요소 체인의 끝에 도달할 때까지 첫 번째 하위 요소에서부터 시작 요소 바로 아래의 하위 요소를 검색합니다.
  2. cniSearchLastChild는 일치항목이 발견될 때 또는 하위 요소 체인의 끝에 도달할 때까지 마지막 하위 요소에서부터 시작 요소 바로 아래의 하위 요소를 검색합니다.
  3. cniSearchNextSibling는 일치항목이 발견될 때 또는 동위 요소 체인의 끝에 도달할 때까지 시작 요소에서부터 다음 동위 요소를 검색합니다.
  4. cniSearchPreviousSibling은 일치항목이 발견될 때 또는 동위 요소 체인의 끝에 도달할 때까지 시작 요소에서부터 이전 동위 요소를 검색합니다.

이 명령을 사용하여 네임스페이스를 인식하는 도메인에 속하는 메시지 내의 요소를 검색하는 경우, 네임스페이스가 빈 문자열인 요소에 대해서만 검색이 수행됩니다. 네임스페이스의 요소를 검색하려면 cniSearchElementNamespace 명령 중 하나를 사용하십시오.

구문

CciElement* cniSearchFirstChild(
    int*                   returnCode,
    CciElement*            targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchLastChild(
    int*                   returnCode,
    CciElement*            targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchNextSibling(
    int*                   returnCode,
    CciElement*            targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);
CciElement* cniSearchPreviousSibling(
    int*                   returnCode,
    CciElement*            targetElement,
    CciCompareMode* mode,
    CciElementType  type,
    CciChar         name);

매개변수

returnCode
함수의 리턴 코드(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
검색이 시작되는 구문 요소 오브젝트의 주소(입력)
mode
사용할 검색 모드(입력). 요소 유형 및 요소 이름의 어떤 조합을 검색할 것인지 나타냅니다. 사용 가능한 값은 다음과 같습니다.
  • CCI_COMPARE_MODE_FULL
  • CCI_COMPARE_MODE_FULL_TYPE
  • CCI_COMPARE_MODE_GENERIC_TYPE
  • CCI_COMPARE_MODE_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NAME
  • CCI_COMPARE_MODE_NAME_SPECIFIC_TYPE
  • CCI_COMPARE_MODE_NAME_GENERIC_TYPE
  • CCI_COMPARE_MODE_NAME_FULL_TYPE
  • CCI_COMPARE_MODE_NULL
type
검색할 요소 유형(입력). 검색 모드에서 유형 일치항목 검색을 수행할 때만 사용됩니다.
이름
검색할 요소 이름(입력). 검색 모드에서 이름 일치항목 검색을 수행할 때만 사용됩니다.

    int                rc;
    CciElement* firstChild = cniSearchFirstChild(
                                                                                                                &rc, 
                                                                                              inRootElement, 
                                                                                              CCI_COMPARE_MODE_NAME, 
                                                                                              elementName, 
                                               0);

리턴 값

  • 함수가 정상적으로 실행되면, 요청된 구문 요소 오브젝트의 주소가 리턴됩니다.
  • 일치하는 요소가 없으면, 0이 리턴됩니다.
  • 오류가 발생하면, 0(CCI_NULL_ADDR)이 리턴되고 returnCode 매개변수는 오류의 이유를 표시합니다.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as07740_