cpiSetElementName

Zweck

Diese Funktion legt den Namen des angegebenen Syntaxelements fest.

Syntax

void cpiSetElementName(
int*            returnCode,
CciElement*     targetElement,
const CciChar*  name);

Parameter

returnCode
Empfängt den Rückkehrcode von der Funktion (Ausgabe). Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
name
Der Name, der im Zielelement festgelegt werden soll (Eingabe).

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt returnCode die Fehlerursache an.

Beispiel

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

/* Konvertieren Sie den Attributwert ins Brokerformat */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
/* Erstellen Sie ein neues Namenswertelement für das Attribut */
newElement = cpiCreateElement(&rc, parser);
cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
cpiSetElementName(&rc, newElement, data);
if (pc->trace) {
const char * mbData = mbString(data, pc->iCcsid);
fprintf(pc->tracefile, "PLUGIN: Created new NAMEVALUE element; 
object=0x%x type=0x%x name=",
newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
fprintf(pc->tracefile, "%s\n", mbData);
fflush(pc->tracefile);
free((void *)mbData);
}
/* Geben Sie den in 'CciNString()' erstellten Speicherplatz frei */
free((void *)data);
/* Fügen Sie das Element hinzu*/
cpiAddAsLastChild(&rc, element, newElement);
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiSetElementType
cpiSetElementValue-Gruppe
cpiSetElementValueValue
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
as08500_