Palabras clave

De un vistazo

Explora las palabras clave de DelphiScript compatibles con el sistema de scripting de Altium Designer, con declaraciones, descripciones y ejemplos que explican su uso. Esta referencia abarca operadores, sentencias condicionales, bucles, funciones y gestión de excepciones, e indica las limitaciones pertinentes de DelphiScript como lenguaje sin tipos. Sigue leyendo para ampliar tus conocimientos y encontrar la orientación que necesitas sobre las palabras clave para tus scripts.

- 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.
Profundiza con IA:
 

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.

Para obtener información más detallada sobre las diferencias entre DelphiScript y el lenguaje de programación Delphi, consulte la página Diferencias entre DelphiScript y Delphi.

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 do instrucción
  • While expression do instrucción
  • With expression do instrucció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.

Tenga cuidado con el otro uso de la palabra clave Interface, que se utiliza para las secciones Interface/Implementation de una unidad de Embarcadero Delphi. Estas palabras clave Interface/Implementation pueden utilizarse en los scripts, pero, en la práctica, se ignoran cuando se ejecuta un script en Altium Designer.

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

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

AI-LocalizedLocalizado por IA
Si encuentra un problema, seleccione el texto/imagen y presioneCtrl + Enterpara enviarnos sus comentarios.
Nav
Contents
Disponibilidad de funciones

Las funciones disponibles para usted dependen de qué solución de Altium tenga: Altium Develop, Altium Agile Teams, Altium Agile Enterprise o Altium Designer (con suscripción activa).

Si no ve una función documentada en su software actual, contacte con Ventas de Altium para obtener más información.

Documentación heredada

La documentación de Altium Designer ya no está versionada. Si necesita acceder a la documentación de versiones anteriores de Altium Designer, visite la sección Documentación heredada de la página de Otros instaladores.

Contents