cpiSetElementName

Zweck

Legt den Namen des angegebenen Syntaxelements fest.

Syntax

void cpiSetElementName(
  int*            Rückkehrcode,
  CciElement*     Zielelement,
  const CciChar*  Name);

Parameter

Rückkehrcode
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
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
Name
Der Name, der im Zielelement festgelegt werden muss (Eingabe).

Rückgabewerte

Keine. Wenn ein Fehler auftritt, gibt der Rückkehrcode den Grund für den Fehler an.

Beispielprogramm

Dieses Beispiel stammt aus der Musterparserdatei BipSampPluginParser.c (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
Überblick zu benutzerdefinierten Erweiterungen
Zugehörige Tasks
Benutzerdefinierten Parser erstellen
Zugehörige Verweise
cpiSetElementType
cpiSetElementValue-Gruppe
cpiSetElementValueValue
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:00

as08500_