cpiSetElementNamespace

Zweck

Legt das Attribut 'namespace' für das angegebene Syntaxelement fest.

Definiert in Typ Mitglied
CPI_VFT Optional iFpSetElementValue

Syntax

void             cpiSetElementNamespace(
		int*            returnCode,
		CciElement*     targetElement,
		const CciChar*  nameSpace);

Parameter

returnCode
Die Eingabe eines Nullzeigers bedeutet, dass der benutzerdefinierte Knoten nicht für Fehler zuständig sein möchte. Jegliche während der Ausführung dieses Aufrufs ausgelösten Ausnahmebedingungen werden beim nächsten übergeordneten Knoten im Fluss erneut ausgelöst. Ist eine Eingabe nicht NULL, bedeutet die Ausgabe den Erfolgsstatus des Aufrufs. Wenn während der Ausführung eine Ausnahmebedingung auftritt, wird *returnCode bei der Ausgabe auf CCI_EXCEPTION gesetzt. Rufen Sie cciGetLastExceptionData für Details der Ausnahmebedingung auf. (Eingabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
Die Adresse des aktuellen Syntaxelements (Eingabe).
targetElement
Gibt die Adresse des Zielsyntaxelementobjekts an.
value
Gibt die Adresse einer mit Null abgeschlossenen Zeichenfolge von CciChars an, die den Namespace-Wert darstellen. Eine leere Zeichenfolge ist ein gültiger Wert für den Namespace. Elemente werden standardmäßig im Namespace der leeren Zeichenfolge erstellt, d. h. die Angabe einer leeren Zeichenfolge als Namespace über diese API ist nur von Wirkung, wenn das Element zuvor in einem anderen Namespace war und die gewünschte Wirkung darin besteht, den Namespace-Wert in eine leere Zeichenfolge zu ändern.

Rückgabewerte

Keine.

Beispielprogramm

/* Attributwert in Brokerform konvertieren */
          data = CciNString((char *)startMarker, markedSize, pc->iCcsid);

/* Create a new name-value element for the attribute */
          newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
          cpiSetElementName(&rc, newElement, data);
          cpiSetElementNamespace(&rc, newElement, data);
          if (pc->trace) {
            const char * mbData = mbString(data, pc->iCcsid);
            fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE 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);
          }
          /* Free the memory created in CciNString() */
          free((void *)data);

          /* Element hinzufügen */
          cpiAddAsLastChild(&rc, element, newElement);
Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Tasks
Parser in C erstellen
Zugehörige Verweise
cpiElementNameSpace
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08185_