cpiSetNameFromBuffer

Zweck

Legt das Namensattribut des Zielsyntaxelements fest, indem die im Puffer gelieferten Daten verwendet werden, auf die der Parameter Name zeigt. Die Größe des Namens wird mit Hilfe des Parameters Länge angegeben.

Syntax

void cpiSetNameFromBuffer(
  int*            Rückkehrcode,
  CciElement*     Zielelement,
  const CciChar*  Name,
  CciSize         Länge);

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
  • CCI_INV_DATA_BUFLEN
Zielelement
Gibt die Adresse des Zielsyntaxelementobjekts an (Eingabe).
Name
Die Adresse eines Puffers, der den Namen enthält (Eingabe).
Länge
Die Länge der durch den Namensparameter angegebenen Zeichenfolge, dargestellt als Anzahl von CciChar-Zeichen.

Rückgabewerte

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

Beispielprogramm

/* 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);
          cpiSetNameFromBuffer(&rc, newElement, data, length);
          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
C-Parser-Dienstprogrammfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08540_