cpiRootElement

Zweck

Ruft die Adresse des Stammsyntaxelements des angegebenen Parserobjekts ab.

Syntax

CciElement* cpiRootElement(
  int*        Rückkehrcode,
  CciParser*  Parser);

Parameter

Rückkehrcode
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 (Eingabe). Wenn ein Fehler auftritt, wird null (CCI_NULL_ADDR) zurückgegeben, und der Rückkehrcode gibt den Grund für den Fehler an.

Beispielprogramm

Dieses Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c (Zeile 428 bis 470):

int cpiParseBufferEncoded(
  CciParser*  Parser,
  CciContext* Kontext,
  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 die Markierung zurück, um sicherzustellen, dass die Synatxanalyse korrekt zurückgesetzt wird */
  pc->iInTag = 0;

  /* Wir setzen das Eigentumsrecht des Restpuffers voraus */
  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: 23. Aug. 2006
as08300_