WebSphere Message Brokers
File: as08420_
Writer: Lorraine Waitt

Reference topic

This build: July 31, 2007 21:38:11

cpiElementCompletePrevious

Purpose

Gets the value of the 'previous child complete' flag from the target syntax element. This attribute indicates whether the element tree is complete.

Syntax

CciBool cpiElementCompletePrevious(
  int*         returnCode,
  CciElement*  targetElement);

Parameters

returnCode
Receives the return code from the function (output).
Possible return codes are:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Specifies the address of the target syntax element object (input).

Return values

The value of the attribute is returned. If an error occurs, returnCode indicates the reason for the error.

Sample

This example is similar to code taken from the sample parser file BipSampPluginParser.c (lines 491 to 499). In the sample file, the code given is for cpiElementCompleteNext.

if ((!cpiElementCompletePrevious(&rc, element)) &&
      (cpiElementType(&rc, element) == CCI_ELEMENT_TYPE_NAME)) {

    while ((!cpiElementCompletePrevious(&rc, element))     &&
           (!cpiFirstChild(&rc, element)) &&
           (pc->iCurrentElement))
    {
      pc->iCurrentElement = parsePreviousItem(parser, context, pc->iCurrentElement);
    }
Related concepts
User-defined parsers
User-defined extensions overview
Related tasks
Creating a parser in C
Related reference
cpiElementCompleteNext
C parser utility functions
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:38:11

as08420_ This topic's URL is: