@position-Direktive
Aktualisiert: November 2007
Stellt in Fehlermeldungen relevante Positionsinformationen bereit.
@set @position(end | [file = fname ;] [line = lnum ;] [column = cnum])
Argumente
fname
Erforderlich, wenn file verwendet wird. Ein Zeichenfolgenliteral, das einen Dateinamen (mit oder ohne Laufwerks- oder Pfadinformationen) darstellt.lnum
Erforderlich, wenn line verwendet wird. Eine beliebige, nicht negative ganze Zahl, die eine Zeile im geschriebenen Code darstellt.cnum
Erforderlich, wenn column verwendet wird. Eine beliebige, nicht negative ganze Zahl, die eine Spalte im geschriebenen Code darstellt.
Hinweise
Von einem Jscript-Autor geschriebener Programmcode unterscheidet sich manchmal vom tatsächlich kompilierten und ausgeführten Code. Hostumgebungen, z. B. ASP.NET, oder Entwicklungstools können eigenen Code generieren und dem Programm hinzufügen. Dieser Code ist i. A. für den Autor nicht von Bedeutung, aber er kann beim Auftreten von Fehlern u. U. verwirren.
Der Compiler kann möglicherweise die Zeile im Code des Autors nicht richtig identifizieren, in der der Fehler aufgetreten ist, sondern identifiziert irrtümlich eine Fehlerzeile, die im ursprünglich geschriebenen Code gar nicht vorhanden ist. Das hängt damit zusammen, dass sich durch den zusätzlich generierten Code die relative Position des ursprünglichen vom Autor verfassten Codes geändert hat.
Beispiel
Im folgenden Beispiel wird die Zeilennummer in einer Datei geändert, um Platz für Code zu schaffen, der von einem Jscript-Host in den Code des Autors eingefügt wurde. Die Zeilennummern in der linken Spalte stellen die dem Benutzer ursprünglich angezeigte Quelle dar.
01 .. // 10 lines of host-inserted code.
.. .. //...
10 .. // End of host-inserted code.
11 .. @set @position(line = 1)
12 01 var i : int = 42;
13 02 var x = ; // Error reported as being on line 2.
14 03 //Remainder of file.