Diese Funktion ruft die Adresse des Stammsyntaxelements des angegebenen Parserobjekts ab.
CciElement* cpiRootElement(
int* Rückkehrcode,
CciParser* Parser);
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.
Das folgende Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c:
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 Syntaxanalyse korrekt zurückgesetzt wird */
pc->iInTag = 0;
/* Wir setzen das Eigentumsrecht des Restpuffers voraus */
return(pc->iSize);
}