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.

cniSearchElement-Gruppe

Verwenden Sie eine oder mehrere der Funktionen in dieser Gruppe, um vorherige gleichgeordnete Elemente des angegebenen Elements nach einem Element zu durchsuchen, das die angegebenen Kriterien erfüllt.

Die Suche wird beim Syntaxelement begonnen, das im Parameter targetElement angegeben ist. Jede der vier Funktionen stellt eine Suche in eine andere Richtung in der Baumstruktur bereit:
  • cniSearchFirstChild sucht die unmittelbaren untergeordneten Elemente des Anfangselements vom ersten untergeordneten Element an, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette untergeordneter Elemente erreicht wird.
  • cniSearchLastChild sucht die unmittelbaren untergeordneten Elemente des Anfangselements vom letzten untergeordneten Element an, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette untergeordneter Elemente erreicht wird.
  • cniSearchNextSibling sucht vom Anfangselement an zu den nächsten gleichgeordneten Elementen, bis entweder eine Übereinstimmung gefunden oder das Ende der Kette gleichgeordneter Elemente erreicht wird.
  • cniSearchPreviousSibling sucht vom Anfangselement an zu den vorherigen gleichgeordneten Elementen, bis entweder eine Übereinstimmung gefunden oder der Anfang der Kette gleichgeordneter Elemente erreicht wird.

Wenn Sie diesen Befehl verwenden, um nach einem Element in einer Nachricht zu suchen, die zu einer Namespace unterstützenden Domäne gehört, wird die Suche nur bei den Elementen durchgeführt, deren Namespace eine leere Zeichenfolge ist. Wenn Sie eine Suche nach Elementen in allen Namespaces durchführen möchten, verwenden Sie eine der cniSearchElementNamespace-Funktionen.

Syntax

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);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
targetElement
Die Adresse des Syntaxelementobjekts, bei dem die Suche beginnt.
mode
Der zu verwendende Suchmodus (Eingabe). Dieser Parameter gibt an, nach welcher Kombination von Elementtyp und Elementname gesucht werden soll. Dies sind die möglichen Werte:
  • 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
Der Elementtyp, nach dem gesucht werden soll (Eingabe). Verwenden Sie diesen Parameter nur, wenn der Suchmodus eine Übereinstimmung in Bezug auf den Typ einschließt.
name
Der Elementname, nach dem gesucht werden soll (Eingabe). Verwenden Sie diesen Parameter nur, wenn der Suchmodus eine Übereinstimmung in Bezug auf den Namen einschließt.

Beispiel

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

Rückgabewerte

  • Bei Erfolg wird die Adresse des angeforderten Syntaxelementobjekts zurückgegeben.
  • Falls kein passendes Element vorhanden ist, wird null zurückgegeben.
  • Beim Auftreten eines Fehlers wird null (CCI_NULL_ADDR) ausgegeben, und der Parameter returnCode gibt den Grund für den Fehler an.
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

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


ReferenzthemaReferenzthema | Version 8.0.0.5 | as07740_