WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cpiParent

Diese Funktion gibt die Adresse des Syntaxelementobjekts, das das übergeordnete Element des angegebenen Zielelements ist, zurück.

Syntax

CciElement* cpiParent(
  int*               returnCode,
  const CciElement*  targetElement);

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).

Rückgabewerte

Falls erfolgreich, wird die Adresse des erforderlichen Syntaxelements zurückgegeben. Wenn kein übergeordnetes Element vorhanden ist, wird null zurückgegeben. Wenn ein Fehler auftritt, wird null (CCI_NULL_ADDR) zurückgegeben, und der Rückkehrcodeparameter gibt den Grund für den Fehler an.

Beispiel

Das folgende Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c:

void* parseNextItem(
  CciParser*  parser,
  CciContext* context,                
  CciElement* element
){
  void*              Endmarke;
  void*              Startmarke;
  PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context;
  CciElement*        Rückkehrelement = Element;
  CciElement*        neues Element;
  size_t             markedSize;
  const CciChar*     Daten;
  int             rc;

  if (pc->trace) 

  /* Überspringen Sie jeden Leerraum */
  skipWhiteSpace( (PARSER_CONTEXT_ST *)context );

  /* Sind wir am Ende des Puffers? */
  if (pc->iIndex == pc->iSize)
        return(0);
  }

  /* Sind wir innerhalb eines Tags? */
  if (pc->iInTag) {

    if (pc->iCurrentCharacter == chCloseAngle) {

      /* Wir sind am Ende eines Tags angelangt */
      pc->iInTag = 0;
      advance( (PARSER_CONTEXT_ST *)context, parser );
    }
    else if (pc->iCurrentCharacter == chForwardSlash) {

      /* Wir haben möglicherweise das Ende eines leeren Tags erreicht */
      advance( (PARSER_CONTEXT_ST *)context, parser );

      if (pc->iCurrentCharacter == chCloseAngle) {

        pc->iInTag = 0;
        advance( (PARSER_CONTEXT_ST *)context, parser );

        cpiSetElementCompleteNext(&rc, element, 1);
        
        returnElement = cpiParent(&rc, element);
      }
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:03


ReferenzthemaReferenzthema | Version 8.0.0.5 | as08310_