@XMLPUTATTR[name,namespaceURI,value] : Schreibt ein XML-Attribut

 

@XMLPUTATTR schreibt ein XML-Attribut auf das aktuell geöffnete XML-Element. Es muss direkt nach dem Aufruf von @XMLSTARTELEMENT und vor allen Aufrufen von @XMLPUTSTRING, @XMLPUTCOMMENT oder @XMLPUTRAW aufgerufen werden. Die Datei muss mit einem vorherigen @XMLOPEN geöffnet worden sein.

 

Wenn name ein lokaler Name ohne Präfix ist, führt die Klasse automatisch ein neues xmlns="NamespaceURI"-Attribut ein, falls erforderlich.

Wenn name in der Form prefix:local vorliegt, führt die Klasse automatisch ein neues xmlns:prefix="NamespaceURI" ein, falls erforderlich.

Bestimmte Attributnamen werden von dieser Methode auf besondere Weise behandelt. Wenn name "xmlns" ist oder das Präfix "xmlns" verwendet, wird das Attribut als Namespace-Deklaration interpretiert, unabhängig vom Wert von NamespaceURI.  Ebenso wird jedes Attribut mit dem Präfix "xml" als spezielles Attribut (wie "xml:lang") interpretiert und NamespaceURI wird ignoriert.

Gibt bei Erfolg 0 oder bei einem Fehler einen XML-Fehler zurück.

 

Beispiel:

 

Um dieses XML mit dem Namen books.xmlzu erstellen :

 

<book xmlns='urn:loc.gov:books' xmlns:isbn='urn:ISBN:0-395-36341-6'>

<title>Cheaper by the Dozen</title>

<isbn:number>1568491379</isbn:number>

</book>

 

Verwenden Sie den Code:

 

echo %@xmlcreate[books.xml]

echo %@xmlstartelement[book,urn:loc.gov:books]

echo %@xmlputattr[xmlns:isbn,"",urn:ISBN:0-395-36341-6]

echo %@xmlputelement[title,urn:loc.gov:books,Cheaper by the Dozen]

echo %@xmlputelement[isbn:number,urn:ISBN:0-395-36341-6,1568491379);

echo %@xmlendelement[]

echo %@xmlclose[]

 

XML-Fehler:

 

101 Ungültiger Attributindex

102 Keine Attribute vorhanden

103 Ungültiger Namespace-Index

104 Keine Namespaces verfügbar

105 Ungültiger Element-Index

106 Keine Elemente vorhanden

107 Attribut existiert nicht

201 Unausgewogenes Element-Tag

202 Unbekanntes Element-Präfix (Namespace kann nicht gefunden werden)

203 Unbekanntes Attribut-Präfix (kann keinen Namespace finden)

204 Ungültiges XML-Markup

205 Ungültiger Endstatus für Parser

206 Dokument enthält unausgewogene Elemente

207 Ungültiger XPath

208 Kein solches Kind

209 Oberstes Element stimmt nicht mit dem Anfang des Pfades überein

210 DOM-Baum nicht verfügbar

302 Datei kann nicht geöffnet werden

401 Ungültiges XML würde erzeugt werden

402 Es wurde ein ungültiger XML-Name angegeben