A.10 Anhang D: Expansion von Entity- und Zeichenreferenzen (nicht normativ)

Dieser Anhang enthält einige Beispiele, die die Abfolge der Erkennung und Expansion von Entity- und Zeichenreferenzen, wie in A.4.4 beschrieben, illustrieren.

Wenn die DTD folgende Deklaration enthält

<!ENTITY beispiel "<p>Ein et-Zeichen (&#38;#38;) kann 
numerisch (&#38;#38;#38;) oder mit einem allgemeinen
Entity (&amp;amp;) geschützt werden.</p>" >

dann wird der XML-Prozessor die Zeichenreferenzen erkennen, sobald er die Entity-Deklaration analysiert, und wird sie auflösen, um schließlich folgende Zeichenkette als den Wert des Entity beispiel zu speichern:

<p>Ein et-Zeichen (&#38;) kann 
numerisch (&#38;#38;) oder mit einem allgemeinen
Entity (&amp;amp;) geschützt werden.</p>

Eine Referenz auf &beispiel; im Dokument verursacht eine erneute Analyse, in der die Start- und End-Tags des p-Elements erkannt und die drei Referenzen erkannt und expandiert werden. Das Ergebnis ist ein p-Element mit folgendem Inhalt (alles Zeichendaten, keine Begrenzungen oder Markup):

Ein et-Zeichen (&) kann 
numerisch (&) oder mit einem allgemeinen
Entity (&) geschützt werden.

Ein komplexeres Beispiel wird die Regeln und ihre Auswirkungen vollständig illustrieren. Im folgenden Beispiel dienen die Zeilennummern einzig zur Referenzierung:

 1 <?xml version='1.0'?>
 2 <!DOCTYPE test [
 3 <!ELEMENT test (#PCDATA) >
 4 <!ENTITY % xx '&#37;zz;'>
 5 <!ENTITY % zz '&#60;!ENTITY trickreiche "fehler-anfällig" >' >
 6 %xx;
 7 ]>
 8 <test>Dieses Beispiel zeigt eine &trickreiche; Methode.</test>

Dieses führt zu Folgendem:

• In Zeile 4 wird die Referenz auf das Zeichen 37 sofort aufgelöst, und das Parameter-Entity xx wird in der Symboltabelle mit dem Wert %zz; abgelegt. Da der Ersetzungstext nicht noch einmal analysiert wird, wird die Referenz auf das Parameter-Entity zz nicht erkannt. (Und das wäre auch ein Fehler, denn zz ist noch nicht deklariert.)
• In Zeile 5 wird die Zeichenreferenz < sofort expandiert, und das Parameter-Entity zz wird mit dem Ersetzungstext <!ENTITY trickreiche "fehler-anfällige" > abgelegt, was eine wohlgeformte Entity-Deklaration ist.
• In Zeile 6 wird die Referenz auf xx erkannt, und der Ersetzungstext von xx, nämlich %zz;, wird analysiert. Die Referenz auf zz wird seinerseits erkannt und dessen Ersetzungstext (<!ENTITY trickreiche "fehler-anfällige" >) wird analysiert. Das allgemeine Entity trickreiche wurde nun mit dem Ersetzungstext fehler-anfällige deklariert.
• In Zeile 8 wird die Referenz auf das allgemeine Entity trickreiche erkannt und expandiert, so dass der volle Inhalt des Elementes test nun die folgende selbstbeschreibende (und grammatikalisch falsche) Zeichenkette ist: Dieses Beispiel zeigt eine fehler-anfällig Methode.