Schlüsselwörter

Diese Referenz behandelt die DelphiScript-Schlüsselwörter, die für das Skriptsystem in Altium Designer verwendet werden. Das Skriptsystem unterstützt die Sprache DelphiScript, die der Programmiersprache Embarcadero Delphi™ sehr ähnlich ist. Der wesentliche Unterschied besteht darin, dass DelphiScript eine typfreie Skriptsprache ist.

In diesem Abschnitt werden gängige DelphiScript-Schlüsselwörter mit detaillierten Informationen und Beispielen beschrieben. Weitere Informationen zu Schlüsselwörtern, wie z. B. Routinen zur Verarbeitung von Delphi-Dateien, mathematischen Operationen und Zeichenketten, finden Sie unter„Funktionen“ und in der Embarcadero Delphi-Referenz.

Und

Declaration
Der Operator „ And

“ führt ein logisches bzw. bitweises „Und“ aus.

Description
Der Operator „ And “ führt ein logisches „Und“ aus, sofern die Operanden vom Typ „Boolean“ sind, bzw. ein bitweises „Und“, sofern die Operanden Ganzzahlen sind.

Example of a boolean And evaluation:

Var
  I, J : Integer
Begin
  I := $F0;
  J := $8F;
  ShowMessage(IntToStr(I and J));
End;

Example of a logical And evaluation:

Var
  S : String;
Begin
  S := '';
  If (Length(S) > 0) and (S[1\] = 'X') Then Delete(S,1,1);
End;

See also
Schlüsselwort „Or“
XOR-Schlüsselwort

Array

Declaration
Array [index range];

Description
DelphiScript ist eine typfreie Sprache, daher muss die Größe oder der Bereich eines Arrays angegeben werden. Es kann zwar definiert werden, welche Art von Elementen das Array enthalten kann, dies ist jedoch nicht erforderlich. Die Deklaration „ Open array “ wird nicht unterstützt.

Example:

var x : array [1..2]; 

Begin

Declaration
Begin
  statement
End;

Description
Das Schlüsselwort „ begin “ leitet einen Block im Skript ein. Ein Block ist der Hauptteil eines Skripts und kann eine beliebige Anzahl von Anweisungen umfassen. Er kann überall dort verwendet werden, wo eine einzelne Anweisung erforderlich ist, beispielsweise im Hauptteil einer bedingten Anweisung oder einer Schleife.

Example:

Var
  Test : Integer;
Begin
  Test := Test + 4;
  ShowMessage(IntToStr(Test));
End;

See also
Schlüsselwort „End“

Break

Declaration
Break;

Description
Ein „ Break “ springt aus einer Schleife heraus, ähnlich wie bei einer „ Goto “-Anweisung.

Example:

While Condition Do
Begin
  DoSomething;
  Begin
    If AnotherCondition Then
      Break;
  End;
End;

See also
While-Schlüsselwort
Schlüsselwort „Continue“
Do-Schlüsselwort
Schlüsselwort wiederholen

Fall

Declaration
Case expression Of
  Value range : Expression;
Else Expression;
End;

Description
Die Anweisungen „ Case “ wählen je nach Wert des Ausdrucks einen von vielen möglichen Zweigen aus.

In vielen Situationen lässt sich eine komplexe Reihe von „ If “-Anweisungen vereinfachen

,

indem man sie durch „ Case “-Anweisungen ersetzt. Eine „ case “-Anweisung in einem Ausdruck wird verwendet, um einen Wert, eine Liste möglicher Werte oder einen Wertebereich auszuwählen. Da DelphiScript eine typfreie Sprache ist, können in einer „ case “-Anweisung beliebige Typen verwendet werden. „ Case “-Anweisungen können eine „ else “-Anweisung enthalten, die ausgeführt wird, wenn keines der Labels dem Wert des Selektors entspricht (innerhalb der „ Case Of “-Bedingung).

Example 1:

Case Char Of
  '+'     : Text := 'Plus sign';
  '-'     : Text := 'Minus sign';
  '*', '/': Text := 'Multiplication or division';
  '0'..'9': Text := 'Number';
  'a'..'z': Text := 'Lowercase character';
  'A'..'Z': Text := 'Uppercase character';
Else
  Text := 'Unknown character';
End;

Example 2:

Case UserName Of
  Jack', 'Joe' : IsAdministrator := true;
  'Fred' : IsAdministrator := false;
Else
  Raise('Unknown User');
End;

See also
Das Schlüsselwort „Of“

Weiter

Declaration
Continue

Description
Die Anweisung „ Continue “ überspringt den Hauptteil einer Schleife, ähnlich wie die Anweisung „ Goto “;

Example:

Var
  I := 0; s:= 1;
Begin
  While True Do
  Begin
  S := S \* 2;
  I := I \\+ 1;
  If I > 4 then continue;
  Break;
End;

See also
Schlüsselwort „Break“
While-Schlüsselwort
Schlüsselwort „Continue“
Schlüsselwort „Do“
Schlüsselwort „Wiederholen“

Const

Declaration
Const
Name = Expression;

Description
Das Schlüsselwort „ Const “ gibt einen beliebigen Ausdruck mit konstantem Wert als Wert einer Konstante an. Wenn Sie versuchen, den Ausdruck vom Typ „ const “ im Skript zu ändern, löst das Skriptsystem einen Fehler wegen eines nicht deklarierten Bezeichners aus.

Example:

Const
  b = 30;
Begin
  ShowMessage(IntTtStr(b));
End;

Ein Versuch, den Wert des Parameters „ b const “ zu ändern, führt zu einem Fehler, zum Beispiel:

Const
  b = 30;
Begin
  b := 40;
  ShowMessage(IntToStr(b));
End;

Div

Declaration
dividend div divisor

Description
Der Operator „ Div “ führt eine ganzzahlige Division durch, bei der die Dezimalanteile ohne Rundung verworfen werden. Ist der Divisor Null, meldet DelphiScript einen Fehler.

See also
Mod-Operator
Div-Operator

Do

Declaration

• For variable := expression1 to expression2 do Anweisung
• While expression do Anweisung
• With expression do Anweisung.

Description
Das Schlüsselwort „ Do “ ist Teil der „ For, While and With “-Anweisungen von DelphiScript.

Example:

For i := 0 To AnIndex - 1 Do
  S := S + #13 + AString;

See also
Für das Schlüsselwort
Zum Schlüsselwort
Schlüsselwort „While“
Mit dem Schlüsselwort
Bis zum Stichwort

DownTo

Declaration
For variable := expression1 DownTo expression2 Do statement.

Description
Verwenden Sie „ DownTo “ in einer „ For “-Schleife, um herunterzuzählen.

See also
Für das Schlüsselwort
Schlüsselwort „To“
Schlüsselwort ausführen

Sonst

Declaration

• If condition then statement Else statement
• Try statement except exception Else statement end
• Case expression of Else end;

Description
Das Schlüsselwort „ Else “ leitet den „catch-all“-Teil mehrerer Anweisungen ein. Beachten Sie, dass auf den Teil „ else “ einer „ if “-Anweisung eine einzelne Anweisung folgt, während der Teil „ else “ der Anweisungen „ try-except “ und „ case “ mehrere Anweisungen enthalten kann.

See also
Wenn das Schlüsselwort
Dann-Schlüsselwort
Try-Schlüsselwort
Case-Schlüsselwort

Ende

Declaration

• Begin statements End;
• Try statements Except Exception clauses... else Statements... End;
• Try statements Finally statements End;
• Case Expression of clauses Else statements... End;

Description
Das Schlüsselwort „ End “ beendet einen Block oder einen mehrteiligen Abschnitt wie Deklarationen, „ Case “-Anweisungen und so weiter.

See also
Schlüsselwort „Begin“
Schlüsselwort „Case“
Schlüsselwort „Try“

„Except“

Declaration
Try statements Except statements End;

Description
Verwenden Sie „ Try-Except “-Blöcke, um Ausnahmefälle zu behandeln, beispielsweise um bestimmte Ausnahmen abzufangen und sinnvoll damit umzugehen, z. B. sie einem Fehlerprotokoll hinzuzufügen oder ein benutzerfreundliches Dialogfeld zu erstellen. Da das Schlüsselwort „ On “ in DelphiScript nicht unterstützt wird, verwenden Sie die Anweisung „ Raise “ innerhalb des „ Except “-Blocks und geben Sie lediglich eine Textmeldung aus.

Example:

Try
  X := Y/Z;
Except
  Raise('A divide by zero error!');
End;

See also
Schlüsselwort „End“
Schlüsselwort „Finally“
Schlüsselwort „Try“

„Finally“

Declaration
Try statements... Finally statements... End;

Description
Das Schlüsselwort „ finally “ leitet den „finally“-Teil eines „ try-finally “-Blocks ein. Die Anweisungen im „ finally “-Block werden immer ausgeführt, unabhängig davon, wie die Steuerung den „ try “-Block verlässt – sei es durch eine Ausnahme, einen „exit“ oder einen „break“. Die Verwendung des „try-finally “-Blocks wird empfohlen, wenn es um die Erstellung/Zerstörung von Objekten und Datei-E/A geht.

See also
Schlüsselwort „End“
Schlüsselwort „Raise“
Schlüsselwort „Try“

Für

Declaration

• for variable := expression1 to expression2 do statement
• for variable := expression1 downto expression2 do statement

Description
Eine „ for “-Schleife wertet die Ausdrücke aus, die die Grenzen dieser Schleife festlegen, und führt anschließend den Schleifenkörper wiederholt über die Schleifensteuerungsvariable aus, die nach jeder Iteration aktualisiert wird.

Example:

For i := 0 to AnIndex - 1 Do
Begin
  S := S + #13 + AString;
End;
ShowMessage(S);

See also
Do-Schlüsselwort
Schlüsselwort „DownTo“
Schlüsselwort „Repeat“
Bis zum Schlüsselwort
Während Schlüsselwort
Mit Schlüsselwort

Weiter

Declaration
subroutine header; forward;

Description
Die Anweisung „ Forward “ ermöglicht es, eine Funktion oder Prozedur vor ihrem Aufruf zu deklarieren, indem der Header (Name, Parameter und Rückgabetyp) mit der Anweisung „ forward “ deklariert wird.

Funktion

Declaration
Function name (parameters) : return type;

Description
Eine „ Function “ ist eine Unterroutine, die einen Wert zurückgibt. Beachten Sie, dass Zeiger auf Funktionen in Skripten nicht zulässig sind – das heißt, Funktionstypen können nicht definiert werden. Auf Variablen, die innerhalb einer Funktion deklariert wurden, kann außerhalb dieser Prozedur nicht zugegriffen werden.

Example

Function TestFunc(Min, Max : integer) : integer;
Begin
  Result := Random(Max - Min +1);
End;

Goto

Declaration
goto label

Description
Die Anweisung „ goto “ übergibt die Steuerung an das angegebene Label. Das Label kann ein beliebiger Bezeichner oder eine Ziffernfolge mit bis zu vier Ziffern sein.

Example

Label StartHere;
// code
 
StartHere: //do anything;
 
Goto StartHere;

See also
Schlüsselwort „Label“

Wenn

Declaration

• if condition then statement;
• if condition then statement1 else statement2;

Description
Die Bedingung für das Schlüsselwort „ If “ muss ein boolescher Ausdruck sein. Das Schlüsselwort „ Else “ ist optional.

Example

Wenn A > B Dann
    ShowMessage('X > Y und A > B');
Sonst
    ShowMessage('X > Y und A <= B');
Ende;</code></wrap></pre>

<p><wrap><strong>Siehe auch</strong></wrap><br>
    <a href="#And">Schlüsselwort „And“</a><br>
    <a href="#Begin">Schlüsselwort „Begin“</a><br>
    <a href="#Or">Schlüsselwort „Or“</a><br>
	<a href="#Then">Schlüsselwort „Then“</a><br>
    <a href="#Else">Schlüsselwort „Else“</a>
</p>

<p><a id="Interface" name="Interface"></a>
</p>

<h3>Schnittstelle</h3>

<p><wrap><strong>Deklaration</strong></wrap><br>
    <wrap><code>Schnittstelle<br>
    // Global eindeutige Kennungszeichenfolge.<br>
    Methoden<br>
	Eigenschaften<br>
    Ende;</code></wrap>
</p>

<p><wrap><strong>Beschreibung</strong></wrap><br>
    Das Schlüsselwort <wrap><code>interface</code></wrap> ermöglicht den Zugriff auf ein vorhandenes Objekt im Speicher und ruft die Methoden des Objekts auf. Eine Schnittstelle kann nur aus Eigenschaften und Methoden bestehen – keine Daten. Da Schnittstellen keine Daten enthalten können, müssen ihre Eigenschaften über Methoden schreiben und lesen. Vor allem haben Schnittstellen keine Implementierung, da sie lediglich einen Vertrag mit einem vorhandenen Objekt im Speicher definieren.


Eine Schnittstelle kann als Kontaktpunkt zu einem vorhandenen Objekt im Speicher des Computers betrachtet werden und bietet die Möglichkeit, Daten über die Eigenschaften der Schnittstelle zu lesen und zu schreiben. Die Schnittstelle fordert Daten von dem ihr zugeordneten Objekt an.


DelphiScript ist eine typlose Sprache, daher können Sie keine neuen Typen wie beispielsweise neue Datensätze, Arrays oder Klassen sowie zugehörige Schnittstellen definieren.




	Beachten Sie die andere Verwendung des Schlüsselworts „ Interface “, das für die Abschnitte „Interface“ und „Implementation“ einer Embarcadero-Delphi-Unit verwendet wird. Diese Schlüsselwörter „Interface“ und „Implementation“ können in Skripten verwendet werden, werden jedoch bei der Ausführung eines Skripts in Altium Designer im Wesentlichen ignoriert.





Label

Declaration

	label digits, identifier, ...;


Description
 
	Das Schlüsselwort „ label “ deklariert eine oder mehrere Beschriftungen. Eine Beschriftung kann eine Ziffernfolge mit bis zu vier Ziffern oder ein Bezeichner sein. Eine Beschriftung kann im selben Block verwendet werden, um eine Anweisung als Ziel einer „ goto “-Anweisung zu kennzeichnen.


Example:


Label StartHere;
// code
StartHere: //do anything;
Goto StartHere;

See also

	Schlüsselwort „Goto“





Mod

Declaration

	Integer expression mod integer expression


Description
 
	Der Operator „ mod “ führt eine ganzzahlige Modulo- oder Restoperation durch. Das Ergebnis von „ A mod B “ ist „ A - (A div B) * B “.


See also

	Div-Funktion





Nil

Declaration

	const nil = pointer(0);


Description
 
	Das Schlüsselwort „ nil “ ist ein spezieller Zeigerwert, der garantiert eindeutig ist und auf nichts verweist.





Nicht

Declaration



	

		not boolean expression
	
	

		not integer expression
	


Description
 
	Der Operator „ not “ führt eine Negation durch. Ist der Operand vom Typ „boolean“, handelt es sich um eine logische Negation. Not False = True und not true = false. Ist der Operand eine Ganzzahl, führt der Operator „ not “ eine bitweise Negation jedes Bits im Ganzzahlwert durch – das heißt, eine Komplementoperation.





Von

Declaration

	case expression of

	  selector: expression1

	  ...

	end


Description
 
	Das Schlüsselwort „ Of “ wird für die Anweisung „ case “ verwendet.


See also

	Case-Anweisung





Oder

Declaration



	

		boolean expression or boolean expression
	
	

		integer expression or integer expression
	


Description
 
	Der Operator „ or “ führt ein logisches „Oder“ durch, wenn die Operanden vom Typ „bool“, oder ein bitweises „Oder“, wenn die Operanden Ganzzahlen sind. Ein logisches „Oder“ ist nur dann falsch, wenn beide Operanden falsch sind; andernfalls ist es wahr, wenn mindestens ein Operand wahr ist.


See also

	Schlüsselwort „And“

	Schlüsselwort „Not“

	Schlüsselwort „Shl“

	Schlüsselwort „Shr“

	Schlüsselwort „Xor“





Vorgehensweise

Declaration



	

		Procedure name;
	
	

		Procedure Name (Parameter, ...);
	


Description
 
	Das Schlüsselwort „ procedure “ deklariert eine Subroutine ohne Rückgabetyp. Auf Variablen, die innerhalb einer Prozedur deklariert wurden, kann außerhalb dieser Prozedur nicht zugegriffen werden. Beachten Sie, dass dieses Schlüsselwort zwar verwendet werden kann, vom Skriptsystem jedoch ignoriert wird.


Example:


Procedure TestRand(Var Rand: Integer; Max : Integer);
Begin
  Rand := Random(Max);
End;

See also

	Schlüsselwort „function“





Programm

Declaration

	Program Name;

	declarations...

	Block


Description
 
	Das Schlüsselwort „ program “ leitet ein Skript ein. Die Dateiendung für ein Skript lautet „ *.pas “. Beachten Sie, dass dieses Schlüsselwort zwar verwendet werden kann, vom Skriptsystem jedoch ignoriert wird.


See also

	Schlüsselwort „Function“





Raise

Declaration

	Raise statement;


Description
 
	Das Schlüsselwort „ raise “ steht in Zusammenhang mit dem Schlüsselwort „ Try “. Das Schlüsselwort „ Raise “ kann ohne Parameter verwendet werden, um die letzte Ausnahme erneut auszulösen. Es kann auch mit einem String-Parameter verwendet werden, um eine Ausnahme mit einer bestimmten Meldung auszulösen.


Example:


Raise(Format('Invalid Value Entered : %d', \[Height])); 

Beachten Sie, dass das Schlüsselwort „ On “ in DelphiScript nicht unterstützt wird, sodass die „ Exception “-Objekte in Skripten nicht verwendet werden können.





Wiederholung

Declaration

	repeat

	statements;

	until boolean expression


Description
 
	Die Anweisungen innerhalb eines „ Repeat Until “-Blocks werden so lange wiederholt ausgeführt, bis der boolesche Ausdruck wahr ist.


Example:


Repeat
  Write('Enter a value (0..9): ');
  ShowMessage(IntToStr(I));
Until (I >= 0) and (I = 9);

See also

	Schlüsselwort „Until“





Ergebnis

Declaration

	Var result : Function return type;


Description
 
	Jede Funktion in einem Skript muss das Schlüsselwort „ Result “ verwenden, um einen Rückgabewert zurückzugeben. Der Variablentyp entspricht dem Rückgabetyp der Funktion.


See also

	Schlüsselwort „Function“





Shl

Declaration

	value shl bits


Description
 
	Der Operator „ shl “ führt eine Linksverschiebung eines ganzzahligen Werts um Bits Bitpositionen durch. Die frei gewordenen Bits werden auf der rechten Seite mit Nullen aufgefüllt.


See also

	Schlüsselwort „And“

	Schlüsselwort „Not“

	Schlüsselwort „Or“

	Schlüsselwort „Shr“

	XOR-Schlüsselwort





Shr

Declaration

	value shr bits


Description
 
	Der Operator „ shr “ führt eine Rechtsverschiebung eines ganzzahligen Werts um Bits Bitpositionen durch. Die frei gewordenen Bits werden auf der linken Seite mit Nullen aufgefüllt.


See also

	And-Schlüsselwort

	Schlüsselwort „Not“

	Schlüsselwort „Or“

	Schlüsselwort „Shl“

	XOR-Schlüsselwort





Zeichenkette

Declaration



	

		type string;
	
	

		type Name = string[Constant]
	


Description
 
	Das Schlüsselwort „ string “ steht für den Typ „String“.





Dann

Declaration

	If expression then statement


Description
 
	Das Schlüsselwort „ Then “ ist Teil einer „ If “-Anweisung. „
“ 
     „See also “ „
“

    „If“-Schlüsselwort





Zu

Declaration

	For variable := expression1 to expression2 do statement


Description
 
	Das Schlüsselwort „ to “ ist Teil einer „ for “-Schleife, die aufwärts zählt.


Example


For i := 0 to AnIndex - 1 do
  S := S + #13 + AString;

See also

	Schlüsselwort „Downto“

	„For“-Schlüsselwort





Versuchen

Declaration



	

		Try statements finally statements end;
	
	

		Try statements except statements end;
	


Description
 
	Das Schlüsselwort „ try “ leitet eine „ try-except “-Anweisung oder eine „ try-finally “-Anweisung ein. Diese beiden Anweisungen sind miteinander verwandt, dienen jedoch unterschiedlichen Zwecken.



Try Finally
 
	Die Anweisungen im „ finally “-Block werden immer ausgeführt, unabhängig davon, wie die Steuerung den „try“-Block verlässt – durch eine Ausnahme, „Exit“ oder „Break“. Verwenden Sie den „ try-finally “-Block, um temporäre Objekte und andere Ressourcen freizugeben und Bereinigungsmaßnahmen durchzuführen. In der Regel benötigen Sie nicht mehr als eine „ try-finally “-Anweisung in einer Subroutine.


Example:


Reset(F);
Try
  ...  // process file F
Finally
  CloseFile(F);
End;


Try Except
 
	Verwenden Sie „ try-except “, um Ausnahmefälle zu behandeln, beispielsweise um bestimmte Ausnahmen abzufangen und sinnvoll damit umzugehen, wie z. B. sie einem Fehlerprotokoll hinzuzufügen oder ein benutzerfreundliches Dialogfeld zu erstellen. Da das Schlüsselwort „ On “ in DelphiScript nicht unterstützt wird, verwenden Sie die Anweisung „ Raise “ innerhalb des „ Except “-Blocks.


Example:


Try
  X := Y/Z;
Except
  Raise('A divide by zero error!');
End;

See also

	Schlüsselwort „Raise“





Typ

Declaration

	Type Name = type declaration ...


Description
 
	Das Schlüsselwort „ Type “ deklariert den Typ einer Variablen. Da DelphiScript eine typfreie Sprache ist, ist es nicht erforderlich, Variablen eines bestimmten Typs zu deklarieren, dies kann jedoch aus Gründen der Lesbarkeit in Skripten erfolgen. Alle Variablen in einem Skript sind immer vom Typ „Variant“. Die größte Einschränkung beim Schreiben von Skripten besteht darin, dass Sie keine Datensätze oder Klassen deklarieren können.


Typumwandlungen werden in Skripten ignoriert, daher werden Typangaben in Variablendeklarationen ignoriert und können weggelassen werden. Die folgenden Deklarationen sind daher korrekt:


Example:

	var a : integer;

	var b : integer;

	var c, d;


Typangaben bei Parametern in Prozedur-/Funktionsdeklarationen werden ignoriert und können weggelassen werden. Dieser Code ist beispielsweise korrekt:


Function sum(a, b) : integer;
Begin
  Result := a + b;
End;

Im Allgemeinen können Varianten verwendet werden, um beliebige Datentypen zu speichern und zahlreiche Operationen sowie Typkonvertierungen durchzuführen. Ein Variant wird zur Laufzeit typgeprüft und ausgewertet. Der Compiler warnt nicht vor möglichen Fehlern im Code, die nur durch umfangreiche Tests aufgedeckt werden können. Insgesamt können die Codeabschnitte, die Variants verwenden, als interpretierter Code betrachtet werden, da viele Operationen erst zur Laufzeit aufgelöst werden können. Dies kann sich auf die Geschwindigkeit des Codes auswirken.


Example:


Var
V
Begin
  // you can assign to it values of several different types:
  V := 10;
  V := 'Hello, World';
  V := 45.55;
End;

See also

	Schlüsselwort „var“





Unit

Declaration



	

		Unit Name;

		interface

		   declarations

		implementation

		   declarations

		   statements

		Initialization

		   statements

		finalization

		   statements

		end.

		 
	
	

		Unit Name;

		interface

		   declarations

		implementation

		   declarations

		   statements

		begin

		   statements

		end.
	


Das Schlüsselwort „ unit “ definiert eine Einheit, die den Grundbaustein eines Skripts darstellt. Beachten Sie, dass dieses Schlüsselwort zwar verwendet werden kann, vom Skriptsystem jedoch ignoriert wird.


See also

	Schlüsselwort „Function“

	Schlüsselwort „Program“





Bis

Declaration

	Repeat

	Statements;

	Until boolean expression


Description
 
	Das Schlüsselwort „ until “ markiert das Ende des „ Repeat-Until “-Blocks. Die Anweisungen innerhalb eines „ Repeat-Until “-Blocks werden so lange wiederholt ausgeführt, bis der boolesche Ausdruck wahr ist.


Example:


Repeat
  Write('Enter a value (0..9): ');
  ShowMessage(IntToStr(I));
Until (I >= 0) and (I = 9);

See also

	Schlüsselwort „Repeat“





Verwendung

Declaration

	Uses Unit Name, ...;


Description
 
	Das Schlüsselwort „ uses “ listet die Namen der Einheiten auf, die in die umgebende Einheit importiert werden. Die Deklaration „ uses “ ist optional, da das Skriptsystem bereits Einheiten unterstützt, die in Altium Designer importiert werden. Sie können die „uses“-Deklaration aus Gründen der Lesbarkeit einfügen.


Alle im selben Projekt gespeicherten Einheiten können auf globale Variablen aus jeder dieser Einheiten zugreifen. Beachten Sie dies, wenn Sie Variablen in Einheiten innerhalb desselben Projekts deklarieren.


Die APIs „Client“, „PCB“, „Schematic“ und „WorkSpace Manager“ von Altium Designer sowie die „SysUtils“, „Classes“ und andere Einheiten von Delphi werden importiert und stehen in Skripten zur Verfügung – es besteht also keine besondere Notwendigkeit, diese Einheiten in Skripten zu deklarieren.


See also



	
Ausführlichere Informationen zur Altium Designer-API finden Sie in der Dokumentation„Verwendung der Altium Designer-API “.
	





Var

Declaration

	Name : Type

	Name : Type = Expression;


DelphiScript Variables 
 
	Alle Variablen in einem Skript sind immer vom Typ „Variant“. Typumwandlungen werden ignoriert. Typangaben bei der Variablendeklaration werden ignoriert und
können weggelassen werden
, sodass folgende Deklarationen korrekt sind:

    Var a : integer;

	Var b : integer;

	Var c, d; 


Typangaben bei der Deklaration von Prozeduren und Funktionen werden ignoriert und können weggelassen werden. Der folgende Code ist beispielsweise korrekt:


Function sum(a, b) : integer;
Begin
  Result := a + b;
End;

Im Allgemeinen können Varianten verwendet werden, um beliebige Datentypen zu speichern und zahlreiche Operationen sowie Typkonvertierungen durchzuführen. Eine Variante wird zur Laufzeit typgeprüft und ausgewertet. Der Compiler warnt nicht vor möglichen Fehlern im Code, die nur durch umfangreiche Tests aufgedeckt werden können. Insgesamt können die Codeabschnitte, die Varianten verwenden, als interpretierter Code betrachtet werden, da viele Operationen erst zur Laufzeit aufgelöst werden können. Dies kann sich auf die Geschwindigkeit des Codes auswirken.


Deklaration einer Variantenvariablen:


Var
  V;
Begin
  // you can assign to it values of several different types:
  V := 10;
  V := 'Hello, World';
  V := 45.55;
End;


Array elements
 
	Der Typ der Array-Elemente wird ignoriert und kann weggelassen werden, sodass diese Deklarationen gleichwertig sind:

	Var x : array [1..2] of double;

	Var x : array [1..2];


Illegal array example:

	Type

	  TVertices = Array [1..50] Of TLocation;

	Var

	  NewVertices : TVertices;


Legal array example:

	Var

	  NewVertices : Array [1..50] of TLocation;





Während

Declaration

	while expression do statement


Description
 
	die Anweisung „ while “ die Anweisung so lange wiederholt, wie der Ausdruck wahr ist.


See also

	Schlüsselwort „break“

	Schlüsselwort „Continue“

	Schlüsselwort „Do“

	Schlüsselwort „DownTo“

	Schlüsselwort „For“

	Schlüsselwort „Repeat“

	Bis zum Schlüsselwort

	Mit Schlüsselwort





Mit

Declaration

	with expression do statement


Description
 
	Die Anweisung „ With “ fügt dem Gültigkeitsbereich für die Auflösung von Symbolnamen eine Referenz auf einen Datensatz, ein Objekt, eine Klasse oder eine Schnittstelle hinzu.


Normal version example:


Form.Canvas.Pen.Width := 2;
Form.Canvas.Pen.Color := clSilver;

With version example:


With Form.Canvas.Pen do
Begin
  Width := 2;
  Color := clSilver;
End;

See also

	Do-Schlüsselwort





XOR

Declaration



	

		Boolescher Ausdruck XOR Boolescher Ausdruck
	
	

		integer expression Xor integer expression
	


Description
 
	Der Operator „ xor “ führt eine Exklusive-Oder-Operation auf seine Operanden durch. Sind die Operanden vom Typ „bool“, gibt er ein boolesches Ergebnis zurück – „true“, wenn die Operanden unterschiedlich sind, und „false“, wenn sie identisch sind.


Ein ganzzahliger „ xor “-Operator wirkt auf jedes Bit seiner Operanden ein und setzt das Ergebnisbit auf „ 1 “, wenn die entsprechenden Bits in beiden Operanden unterschiedlich sind, und auf „0“, wenn beide Operanden identische Bits aufweisen. Ist ein Operand kleiner als der andere, wird der kleinere Operand in den Bits ganz links mit „ 0 “ aufgefüllt.


See also

	Und das Schlüsselwort

	Nicht-Schlüsselwort

	Oder-Schlüsselwort

	Schlüsselwort „Shl“

	Schlüsselwort „Shr“