Palabras clave
De un vistazo
- Aprende la sintaxis y el comportamiento de las palabras clave habituales de DelphiScript.
- Consulta ejemplos de flujo de control, declaraciones y gestión de errores.
- Identifica las restricciones del lenguaje, incluida la falta de compatibilidad con las declaraciones de matrices abiertas y los punteros a funciones.
Esta referencia abarca las palabras clave de DelphiScript utilizadas en el sistema de scripting de Altium Designer. El sistema de scripting admite el lenguaje DelphiScript, que es muy similar al lenguaje de programación Embarcadero Delphi™. La diferencia principal es que DelphiScript es un lenguaje de scripting sin tipos.
En esta sección se describen las palabras clave habituales de DelphiScript con información detallada y ejemplos. Para obtener más información sobre las palabras clave, como las rutinas de Delphi para el manejo de archivos, operaciones matemáticas y cadenas, consulte Funciones y la Referencia de Embarcadero Delphi.
And
Declaration
El operador And realiza una operación AND lógica o bit a bit.
Description
El operador And realiza una operación AND lógica si los operandos son de tipo booleano, o una operación AND bit a bit si los operandos son enteros.
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
Palabra clave Or
Palabra clave Xor
Array
Declaration
Array [index range];
Description
DelphiScript es un lenguaje sin tipos, por lo que es necesario especificar el tamaño o el rango de un array. Se puede definir el tipo de elementos que puede contener el array, pero no es necesario. No se admite la declaración Open array.
Example:
var x : array [1..2];
Begin
Declaration
Begin
statement
End;
Description
La palabra clave begin inicia un bloque en el script. Un bloque es el cuerpo principal de un script y puede contener cualquier número de instrucciones. Puede utilizarse en cualquier lugar donde se requiera una sola instrucción, como el cuerpo de una instrucción condicional o de un bucle.
Example:
Var
Test : Integer;
Begin
Test := Test + 4;
ShowMessage(IntToStr(Test));
End;
See also
Palabra clave End
Break
Declaration
Break;
Description
Una instrucción Break permite salir de un bucle, de forma similar a una instrucción Goto.
Example:
While Condition Do
Begin
DoSomething;
Begin
If AnotherCondition Then
Break;
End;
End;
See also
Palabra clave While
Palabra clave Continue
Palabra clave Do
Palabra clave Repeat
Case
Declaration
Case expression Of
Value range : Expression;
Else Expression;
End;
Description
Las instrucciones Case seleccionan una rama entre varias posibles, en función del valor de la expresión.
En muchas situaciones, un conjunto complejo de instrucciones If puede simplificarse sustituyéndolas por instrucciones Case. Una instrucción case en una expresión se utiliza para seleccionar un valor, una lista de valores posibles o un rango de valores. En una instrucción case puede utilizarse cualquier tipo, ya que DelphiScript es un lenguaje sin tipos. Las instrucciones Case pueden tener una instrucción else que se ejecuta si ninguna de las etiquetas corresponde al valor del selector (dentro de la condición Case Of).
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
Palabra clave Of
Continue
Declaration
Continue
Description
La instrucción Continue omite el cuerpo de un bucle, de forma similar a la instrucción 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
Palabra clave Break
Palabra clave While
Palabra clave Continue
Palabra clave Do
Palabra clave Repeat
Const
Declaration
Const
Name = Expression;
Description
La palabra clave Const permite especificar cualquier expresión de valor constante como valor de una constante. Si intenta modificar en el script una expresión de tipo const, el sistema de scripting generará un error de identificador no declarado.
Example:
Const
b = 30;
Begin
ShowMessage(IntTtStr(b));
End;
Si se intenta cambiar el valor del parámetro b const, se generará un error; por ejemplo:
Const
b = 30;
Begin
b := 40;
ShowMessage(IntToStr(b));
End;
Div
Declaration
dividend div divisor
Description
El operador Div realiza una división entera que descarta los resultados fraccionarios sin redondear. Si el divisor es cero, DelphiScript notifica un error.
See also
Operador Mod
Operador Div
Do
Declaration
-
For variable := expression1 to expression2 doinstrucción -
While expression doinstrucción -
With expression doinstrucción.
Description
La palabra clave Do forma parte de las instrucciones For, While and With de DelphiScript.
Example:
For i := 0 To AnIndex - 1 Do
S := S + #13 + AString;
See also
Palabra clave For
Palabra clave To
Palabra clave While
Palabra clave With
Palabra clave DownTo
DownTo
Declaration
For variable := expression1 DownTo expression2 Do statement.
Description
Utilice DownTo en un bucle For para contar en sentido descendente.
See also
Palabra clave For
Palabra clave To
Palabra clave Do
Else
Declaration
-
If condition then statement Else statement -
Try statement except exception Else statement end -
Case expression of Else end;
Description
La palabra clave Else introduce la parte que cubre los casos restantes en varias instrucciones. Tenga en cuenta que la parte else de una instrucción if va seguida de una sola instrucción, pero la parte else de las instrucciones try-except y case puede contener varias instrucciones.
See also
Palabra clave If
Palabra clave Then
Palabra clave Try
Palabra clave Case
End
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
La palabra clave End finaliza un bloque o una sección compuesta por varias partes, como declaraciones, instrucciones Case, etc.
See also
Palabra clave Begin
Palabra clave Case
Palabra clave Try
Except
Declaration
Try statements Except statements End;
Description
Utilice bloques Try-Except para gestionar casos excepcionales; por ejemplo, para capturar excepciones específicas y realizar alguna acción útil con ellas, como añadirlas a un registro de errores o crear un cuadro de diálogo fácil de entender. Dado que DelphiScript no admite la palabra clave On, utilice la instrucción Raise dentro del bloque Except y muestre únicamente un mensaje de texto.
Example:
Try
X := Y/Z;
Except
Raise('A divide by zero error!');
End;
See also
Palabra clave End
Palabra clave Finally
Palabra clave Try
Finally
Declaration
Try statements... Finally statements... End;
Description
La palabra clave finally inicia la parte finally de un bloque try-finally. Las instrucciones del bloque finally siempre se ejecutan, independientemente de cómo se salga del bloque try: mediante una excepción, exit o break. Se recomienda utilizar el bloque try-finally cuando se trabaje con la creación y destrucción de objetos y con la entrada/salida de archivos.
See also
Palabra clave End
Palabra clave Raise
Palabra clave Try
For
Declaration
-
for variable := expression1 to expression2 do statement -
for variable := expression1 downto expression2 do statement
Description
Un bucle for evalúa las expresiones que especifican sus límites y, a continuación, ejecuta repetidamente el cuerpo del bucle mediante la variable de control, que se actualiza después de cada iteración.
Example:
For i := 0 to AnIndex - 1 Do
Begin
S := S + #13 + AString;
End;
ShowMessage(S);
See also
Palabra clave Do
Palabra clave DownTo
Palabra clave Repeat
Palabra clave To
Palabra clave While
Palabra clave With
Forward
Declaration
subroutine header; forward;
Description
La directiva Forward permite declarar una función o un procedimiento antes de llamarlo, declarando su cabecera (nombre, parámetros y tipo de retorno) con la directiva forward.
Function
Declaration
Function name (parameters) : return type;
Description
Una Function es una subrutina que devuelve un valor. Tenga en cuenta que no se permiten punteros a funciones en los scripts; es decir, no se pueden definir tipos de función. Las variables declaradas dentro de una función no son accesibles desde fuera de ella.
Example
Function TestFunc(Min, Max : integer) : integer;
Begin
Result := Random(Max - Min +1);
End;
Goto
Declaration
goto label
Description
La instrucción goto transfiere el control a la etiqueta indicada. La etiqueta puede ser cualquier identificador o una cadena numérica de hasta cuatro dígitos.
Example
Label StartHere;
// code
StartHere: //do anything;
Goto StartHere;
See also
Palabra clave Label
If
Declaration
-
if condition then statement; -
if condition then statement1 else statement2;
Description
La condición de la palabra clave If debe ser una expresión booleana. La palabra clave Else es opcional.
Example
If A > B Then
ShowMessage('X>Y and A > B');
Else
ShowMessage('X>Y and A <=B');
End;
See also
Palabra clave And
Palabra clave Begin
Palabra clave Or
Palabra clave Then
Palabra clave Else
Interface
Declaration
Interface
// Globally unique identifier string.
Methods
Properties
End;
Description
La palabra clave interface permite acceder a un objeto existente en memoria e invocar sus métodos. Una interfaz solo puede contener propiedades y métodos, no datos. Dado que las interfaces no pueden contener datos, sus propiedades deben realizar las operaciones de lectura y escritura mediante métodos. Lo más importante es que las interfaces no tienen implementación, ya que solo definen un contrato con un objeto existente en memoria.
Una interfaz puede considerarse un punto de contacto con un objeto existente en la memoria del ordenador y ofrece la posibilidad de leer y escribir datos a través de sus propiedades. La interfaz solicita datos a su objeto asociado.
DelphiScript es un lenguaje sin tipos; por lo tanto, no se pueden definir nuevos tipos, como registros, matrices o clases, ni sus interfaces asociadas.
Label
Declaration
label digits, identifier, ...;
Description
La palabra clave label declara una o más etiquetas. Una etiqueta puede ser una cadena de hasta cuatro dígitos o un identificador. Una etiqueta puede utilizarse en el mismo bloque para identificar una sentencia como destino de una sentencia goto.
Example:
Label StartHere;
// code
StartHere: //do anything;
Goto StartHere;
See also
Palabra clave Goto
Mod
Declaration
Integer expression mod integer expression
Description
El operador mod realiza una operación de módulo entero o resto. El resultado de A mod B es A - (A div B) * B.
See also
Función Div
Nil
Declaration
const nil = pointer(0);
Description
La palabra clave nil es un valor de puntero especial que garantiza ser distinto de cualquier puntero válido y no apuntar a nada.
Not
Declaration
-
not boolean expression -
not integer expression
Description
El operador not realiza una negación. Si el operando es de tipo booleano, la negación es lógica. Not False = True y not true = false. Si el operando es un entero, el operador not realiza una negación bit a bit de cada bit del valor entero, es decir, una operación de complemento.
Of
Declaration
case expression of
selector: expression1
...
end
Description
La palabra clave Of se utiliza en la sentencia case.
See also
Sentencia Case
Or
Declaration
-
boolean expression or boolean expression -
integer expression or integer expression
Description
El operador or realiza una operación OR lógica si los operandos son de tipo booleano, o una operación OR bit a bit si los operandos son enteros. Una operación OR lógica es falsa únicamente si ambos operandos son falsos; de lo contrario, es verdadera cuando al menos uno de los operandos es verdadero.
See also
Palabra clave And
Palabra clave Not
Palabra clave Shl
Palabra clave Shr
Palabra clave Xor
Procedure
Declaration
-
Procedure name; -
Procedure Name (Parameter, ...);
Description
La palabra clave procedure declara una subrutina que no tiene un tipo de retorno. Las variables declaradas dentro de un procedimiento no son accesibles fuera de él. Tenga en cuenta que esta palabra clave puede utilizarse, pero el sistema de scripts la ignora.
Example:
Procedure TestRand(Var Rand: Integer; Max : Integer);
Begin
Rand := Random(Max);
End;
See also
Palabra clave Function
Program
Declaration
Program Name;
declarations...
Block
Description
La palabra clave program inicia un script. La extensión de archivo de un script es *.pas. Tenga en cuenta que esta palabra clave puede utilizarse, pero el sistema de scripts la ignora.
See also
Palabra clave Function
Raise
Declaration
Raise statement;
Description
La palabra clave raise está relacionada con la palabra clave Try. La palabra clave Raise puede utilizarse sin parámetros para volver a lanzar la última excepción. También puede utilizarse con un parámetro de cadena para lanzar una excepción con un mensaje específico.
Example:
Raise(Format('Invalid Value Entered : %d', \[Height]));
Tenga en cuenta que la palabra clave On no es compatible con DelphiScript, por lo que los objetos Exception no pueden utilizarse en los scripts.
Repeat
Declaration
repeat
statements;
until boolean expression
Description
Las sentencias dentro de un bloque Repeat Until se ejecutan repetidamente hasta que la expresión booleana es verdadera.
Example:
Repeat
Write('Enter a value (0..9): ');
ShowMessage(IntToStr(I));
Until (I >= 0) and (I <= 9);
See also
Palabra clave Until
Result
Declaration
Var result : Function return type;
Description
Todas las funciones de un script deben utilizar la palabra clave Result para devolver un valor resultante. El tipo de la variable es el tipo de retorno de la función.
See also
Palabra clave Function
Shl
Declaration
value shl bits
Description
El operador shl desplaza un valor entero Bits posiciones de bit hacia la izquierda. Las posiciones que quedan libres a la derecha se rellenan con bits de valor cero.
See also
Palabra clave And
Palabra clave Not
Palabra clave Or
Palabra clave Shr
Palabra clave Xor
Shr
Declaration
value shr bits
Description
El operador shr desplaza un valor entero Bits posiciones de bit hacia la derecha. Las posiciones que quedan libres a la izquierda se rellenan con bits de valor cero.
See also
Palabra clave And
Palabra clave Not
Palabra clave Or
Palabra clave Shl
Palabra clave Xor
String
Declaration
-
type string; -
type Name = string[Constant]
Description
La palabra clave string representa el tipo cadena.
Then
Declaration
If expression then statement
Description
La palabra clave Then forma parte de una sentencia If.
See also
Palabra clave If
To
Declaration
For variable := expression1 to expression2 do statement
Description
La palabra clave to forma parte de un bucle for que cuenta en sentido ascendente.
Example
For i := 0 to AnIndex - 1 do
S := S + #13 + AString;
See also
Palabra clave Downto
Palabra clave For
Try
Declaration
-
Try statements finally statements end; -
Try statements except statements end;
Description
La palabra clave try introduce una sentencia try-except o una sentencia try-finally. Estas dos sentencias están relacionadas, pero tienen finalidades distintas.
Try Finally
Las sentencias del bloque finally se ejecutan siempre, independientemente de cómo se salga del bloque try: mediante una excepción, Exit o Break. Utilice el bloque try-finally para liberar objetos temporales y otros recursos, y para realizar tareas de limpieza. Normalmente no se necesita más de una sentencia try-finally en una subrutina.
Example:
Reset(F);
Try
... // process file F
Finally
CloseFile(F);
End;
Try Except
Utilice try-except para gestionar casos excepcionales; por ejemplo, para capturar excepciones específicas y realizar alguna acción útil con ellas, como añadirlas a un registro de errores o crear un cuadro de diálogo fácil de entender. Dado que la palabra clave On no es compatible con DelphiScript, utilice la sentencia Raise dentro del bloque Except.
Example:
Try
X := Y/Z;
Except
Raise('A divide by zero error!');
End;
See also
Palabra clave Raise
Type
Declaration
Type Name = type declaration ...
Description
La palabra clave Type declara el tipo de una variable. Dado que DelphiScript es un lenguaje sin tipos, no es necesario declarar variables de un tipo específico, pero puede hacerse para facilitar la lectura de los scripts. Todas las variables de un script son siempre de tipo Variant. La principal limitación al escribir scripts es que no se pueden declarar registros ni clases.
Las conversiones explícitas de tipo se ignoran en los scripts, por lo que los tipos en las declaraciones de variables se ignoran y pueden omitirse. Por lo tanto, estas declaraciones son correctas:
Example:
var a : integer;
var b : integer;
var c, d;
Los tipos de los parámetros en las declaraciones de procedimientos y funciones se ignoran y pueden omitirse. Por ejemplo, este código es correcto:
Function sum(a, b) : integer;
Begin
Result := a + b;
End;
En general, las variables de tipo Variant pueden utilizarse para almacenar cualquier tipo de dato y realizar numerosas operaciones y conversiones de tipo. La comprobación del tipo y los cálculos de una variable Variant se realizan en tiempo de ejecución. El compilador no advertirá de posibles errores en el código, que solo pueden detectarse mediante pruebas exhaustivas. En general, las partes del código que utilizan variables de tipo Variant pueden considerarse código interpretado, ya que muchas operaciones no pueden resolverse hasta el tiempo de ejecución. Esto puede afectar a la velocidad del código.
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
Palabra clave 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.
La palabra clave unit introduce una unidad, que es el módulo básico de un script. Tenga en cuenta que esta palabra clave puede utilizarse, pero el sistema de scripts la ignora.
See also
Palabra clave Function
Palabra clave Program
Until
Declaration
Repeat
Statements;
Until boolean expression
Description
La palabra clave until marca el final del bloque Repeat-Until. Las sentencias dentro de un bloque Repeat-Until se ejecutan repetidamente hasta que la expresión booleana es verdadera.
Example:
Repeat
Write('Enter a value (0..9): ');
ShowMessage(IntToStr(I));
Until (I >= 0) and (I <= 9);
See also
Palabra clave Repeat
Uses
Declaration
Uses Unit Name, ...;
Description
La palabra clave uses enumera los nombres de las unidades que se importan en la unidad que la contiene. La declaración uses es opcional porque el sistema de scripts dispone de unidades compatibles que se importan en Altium Designer. Puede incluir la declaración uses para facilitar la lectura.
Todas las unidades almacenadas en el mismo proyecto pueden acceder a las variables globales de cualquiera de estas unidades. Téngalo en cuenta al declarar variables en unidades del mismo proyecto.
Las API Client, PCB, Schematic y WorkSpace Manager de Altium Designer, así como las unidades SysUtils, Classes y otras de Delphi, se importan y están disponibles para su uso en scripts, por lo que no es necesario declarar estas unidades en los scripts.
See also
Para obtener información más detallada sobre la API de Altium Designer, consulte la documentación Uso de la API de Altium Designer.
Var
Declaration
Name : Type
Name : Type = Expression;
DelphiScript Variables
Todas las variables de un script son siempre de tipo Variant. Las conversiones explícitas de tipo se ignoran. Los tipos en las declaraciones de variables se ignoran y pueden omitirse, por lo que estas declaraciones son correctas:
Var a : integer;
Var b : integer;
Var c, d;
Los tipos de los parámetros en las declaraciones de procedimientos o funciones se ignoran y pueden omitirse. Por ejemplo, este código es correcto:
Function sum(a, b) : integer;
Begin
Result := a + b;
End;
En general, las variantes pueden utilizarse para almacenar cualquier tipo de dato y realizar numerosas operaciones y conversiones de tipo. La comprobación de tipos y la evaluación de una variante se realizan en tiempo de ejecución. El compilador no advertirá de posibles errores en el código, que solo pueden detectarse mediante pruebas exhaustivas. En términos generales, las partes del código que utilizan variantes pueden considerarse código interpretado, ya que muchas operaciones no pueden resolverse hasta el tiempo de ejecución. Esto puede afectar a la velocidad del código.
Declaración de una variable de tipo Variant:
Var
V;
Begin
// you can assign to it values of several different types:
V := 10;
V := 'Hello, World';
V := 45.55;
End;
Array elements
El tipo de los elementos de un array se ignora y puede omitirse, por lo que estas declaraciones son equivalentes:
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;
While
Declaration
while expression do statement
Description
La sentencia while ejecuta repetidamente la sentencia mientras la expresión sea verdadera.
See also
Palabra clave Break
Palabra clave Continue
Palabra clave Do
Palabra clave DownTo
Palabra clave For
Palabra clave Repeat
Palabra clave To
Palabra clave With
With
Declaration
with expression do statement
Description
La sentencia With añade una referencia a un registro, objeto, clase o interfaz al ámbito de resolución de nombres de símbolos.
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
Palabra clave Do
Xor
Declaration
- expresión booleana Xor expresión booleana
-
integer expression Xor integer expression
Description
El operador xor realiza una operación O exclusiva con sus operandos. Si los operandos son de tipo booleano, devuelve un resultado booleano: verdadero si los operandos son diferentes y falso si son iguales.
Un xor entre enteros opera sobre cada bit de sus operandos y establece el bit del resultado en 1 si los bits correspondientes de ambos operandos son diferentes, y en 0 si ambos operandos tienen bits idénticos. Si un operando es más pequeño que el otro, el operando más pequeño se amplía con 0 en los bits situados más a la izquierda.
See also
Palabra clave And
Palabra clave Not
Palabra clave Or
Palabra clave Shl
Palabra clave Shr