cpiRootElement

Zweck

Diese Funktion ruft die Adresse des Stammsyntaxelements des angegebenen Parserobjekts ab.

Syntax

CciElement* cpiRootElement(
int*        returnCode,
CciParser*  parser);

Parameter

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

Rückgabewerte

Die Adresse des Stammsyntaxelements wird zurückgegeben. Wenn ein Fehler auftritt, wird null (CCI_NULL_ADDR) zurückgegeben, und returnCode gibt die Fehlerursache an.

Beispiel

Dieses Beispiel wurde aus der Parser-Beispieldatei BipSampPluginParser.c entnommen (Zeile 428 bis 470):

int cpiParseBufferEncoded(
CciParser*  parser,
CciContext* context,
int         encoding,
int         ccsid
){
PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
int                rc;
/* Rufen Sie einen Zeiger auf den Nachrichtenpuffer ab, und erstellen Sie den Relativzeiger */
pc->iBuffer = (void *)cpiBufferPointer(&rc, parser);
pc->iIndex = 0;
/* Speichern Sie das Format des Puffers */
pc->iEncoding = encoding;
pc->iCcsid = ccsid;
/* Speichern Sie die Größe des Puffers */
pc->iSize = cpiBufferSize(&rc, parser);
/* Setzen Sie Daten in das erste Byte im Datenstrom ein */
pc->iCurrentCharacter = cpiBufferByte(&rc, parser, pc->iIndex);
/* Legen Sie das aktuelle Element als Stammelement fest */
pc->iCurrentElement = cpiRootElement(&rc, parser);
/* Setzen Sie das Flag zurück, um sicherzustellen, dass die Synatxanalyse korrekt zurückgesetzt wird */
pc->iInTag = 0;
/* Es wird davon ausgegangen, dass der Pufferrest als Eigner fungiert */
return(pc->iSize);
}
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08300_