Funciones

De un vistazo

Explora las funciones de DelphiScript compatibles con Altium Designer, desde la evaluación de expresiones y el manejo de archivos de texto hasta el uso de rutinas matemáticas, de cadenas y de extensión. Esta referencia también abarca el paso de parámetros, la manipulación de conjuntos y el manejo de excepciones, con ejemplos y notas sobre las características de Delphi no compatibles. Sigue leyendo para encontrar las rutinas y la sintaxis que necesitas para tus scripts de DelphiScript.

- Identifica las rutinas disponibles de entrada/salida de archivos, matemáticas, de cadenas y de extensión, así como las funciones de cadenas no compatibles.
- Aprende a evaluar expresiones, pasar parámetros y sustituir los operadores de conjuntos de Delphi por funciones de DelphiScript.
- Comprende cómo usar Try-Finally, Try-Except y Raise para liberar recursos y manejar excepciones.
Profundiza con IA:

A continuación se describen las instrucciones de función habituales del lenguaje DelphiScript. Las funciones de DelphiScript se presentan en secciones dedicadas a rutinas de E/S de archivos, rutinas matemáticas, rutinas de cadenas y rutinas de extensión.

Cálculo de expresiones con la función Evaluate

La función integrada Evaluate interpreta una cadena que contiene una expresión matemática válida durante la ejecución y devuelve un resultado. Por ejemplo, puede escribir un script como Evaluate(ProcNames[ProcIndex]); y se llamará al procedimiento especificado en ProcNames[ProcIndex].

Para calcular una expresión de este tipo, puede utilizar el método Evaluate, en el que la expresión se especifica mediante el parámetro Expr. Por ejemplo, puede calcular expresiones como las siguientes:

Evaluate('2+5');
Evaluate('((10+15)-5)/2*5');
Evaluate('sin(3.1415926/2)*10');
Evaluate('2.5*log(3)');

Paso de parámetros a funciones y procedimientos

Tanto las funciones como los procedimientos definidos en un script pueden declararse para aceptar parámetros. Además, las funciones se definen para devolver un valor. 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;

Salida de un procedimiento

DelphiScript proporciona las instrucciones Exit y Break para forzar la salida de un procedimiento antes de que finalice de forma natural. Por ejemplo, si el valor de un parámetro no es adecuado, puede que desee mostrar una advertencia al usuario y salir, como se muestra en el siguiente ejemplo.

Procedure DisplayName (s);
Begin
  If s = '' Then
  Begin
    ShowMessage('Please enter a name');
    Exit;
  End;
  ShowMessage(S + ' is shown');
End;

Rutinas de E/S de archivos

DelphiScript dispone de las siguientes rutinas de E/S:

Append

AssignFile

ChDir

CloseFIle

Eof

Eoln

Erase

GetDir

MkDir

Read

Readln

Reset

Rewrite

RmDir

Write

Writeln

 

 

DelphiScript permite escribir información en un archivo de texto y, dado que es un lenguaje sin tipos, todos los valores deben convertirse primero en cadenas.

Aquí, las rutinas Read y ReadLn son equivalentes: leen una línea hasta la siguiente línea, sin incluirla. Una rutina Writeln(String) equivale a una rutina Write(S) y una rutina Write(LineFeed + CarriageReturn).

Para escribir un archivo de texto, utilice los procedimientos AssignFile, ReWrite, Writeln y CloseFile. Para leer un archivo de texto, utilice los procedimientos AssignFile, Reset, Readln y CloseFile. El siguiente ejemplo escribe en un archivo de texto y añade un marcador de fin de línea. Se recomienda utilizar el bloque Try / Finally / End para garantizar la seguridad de los scripts en caso de un fallo de E/S.

Example:

Var
  InputFile : TextFile;
  OutputFile : TextFile;
  I          : Integer;
  Line       : String;
Begin
  AssignFile(OutputFile,eConvertedFile.Text);
  Rewrite(OutputFile);
  AssignFile(InputFIle,eOriginalFIle.Text);
  Reset(InputFile);
 
  Try
  While not EOF(InputFile) do
  Begin
    Readln(InputFile,Line);
    For I := 1 to Length(Line) Do
      Line[I] := UpperCase(Line[I]);
      Writeln(Outputfile, Line);
    End;
  Finally
    CloseFile(InputFile);
    CloseFile(OutputFile);
  End;
End;

Rutinas matemáticas

DelphiScript dispone de las siguientes rutinas matemáticas:

Abs

ArcTan

Cos

Exp

Frac

Int

Random

Randomize

Round

Sin

Sqr

Sqrt

Trunc

 

 

Rutinas de cadenas

DelphiScript dispone de las siguientes rutinas de cadenas, que permiten manipular cadenas o caracteres. En la siguiente tabla solo se muestra un subconjunto de las rutinas de cadenas (la mayoría de las rutinas de cadenas que utiliza DelphiScript se importan de la unidad SysUtils de Embarcadero Delphi):

AnsiCompareStr

AnsiCompareText

AnsiDequotedStr

AnsiExtractQuotedStr

AnsiLowerCase

AnsiPos

AnsiQuotedStr

AnsiSameStr

AnsiSameText

AnsiUpperCase

CompareStr

CompareText

Copy

Delete

FloatToStr

FloatToStrF

Format

Frac

Insert

Int

IsDelimiter

LastDelimiter

Length

LowerCase

Ord

Pos

Pred

QuotedStr

Round

SameText

SetLength

StringOfChar

StringToGUID

Succ

Trim

TrimLeft

TrimRight

UpCase

UpperCase

WideUpperCase

WideLowerCase

WideSameStr

WideSameText

 

 

Las rutinas de cadenas que not admite DelphiScript se detallan en la siguiente tabla:

AnsiContainsStr

AnsiContainsText

AnsiEndsStr

AnsiEndsText

AnsiIndexText

AnsiMatchStr

AnsiMatchText

AnsiReplaceStr

AnsiReplaceText

AnsiResemblesProc

AnsiResemblesText

AnsiStartsStr

AnsiStartsText

Concat

DecodeSoundExInt

DecodeSoundExWord

DupeString

LeftStr

MidStr

NullStr

ReverseString

RightStr

SetString

SoundEx

SoundExCompare

SoundExInt

SoundExProc

SoundExSimilar

SoundExWord

Str

StuffString

Val

 

Rutinas de extensión

Las rutinas de extensión se utilizan al trabajar con procesos de servidor en scripts (un comando es un proceso de servidor encapsulado con parámetros, si los hay), especialmente si necesita extraer o establecer cadenas para los parámetros de los procesos. A continuación se enumeran algunas de estas rutinas.

Para ejecutar parámetros de procesos en un script, pueden ser necesarias las siguientes funciones:

AddColorParameter

AddIntegerParameter

AddLongIntParameter

AddSingleParameter

AddWordParameter

GetIntegerParameter

GetStringParameter

ResetParameters

RunProcess

Useful functions:

SetCursorBusy

ResetCursor

CheckActiveServer

GetActiveServerName

GetCurrentDocumentFileName

RunApplication

SaveCurrentDocument

 

 

Useful dialogs:

ConfirmNoYes

ConfirmNoYesCancel

ShowError

ShowInfo

ShowWarning

 

Uso de conjuntos en DelphiScript

DelphiScript no admite las palabras clave Set y In de Embarcadero Delphi ni los operadores de conjuntos +, -, *, <= y >=. Las palabras clave equivalentes para los operadores de conjuntos se muestran en la siguiente tabla.

DelphiScript no dispone de tipos de conjunto. Para utilizar conjuntos en scripts de DelphiScript, utilice las funciones integradas MkSet, MkSetRange, InSet, SetUnion, SetDifference, SetIntersection y SubSet, que permiten manipular conjuntos en un script de DelphiScript. Estas se describen con más detalle a continuación.

Operadores de conjuntos

Embarcadero Delphi Set Operator keyword

Equivalent DelphiScript Set Operator keyword

+

SetUnion

-

SetDifference

*

SetIntersection

<=

SubSet

=

=

<>

<>

In

InSet

Función MkSet

La función MkSet es un constructor de conjuntos con un número variable de argumentos. Por ejemplo:

Font.Style = MkSet(fsBold,fsItalic);

Aquí, MkSet(fsBold,fsItalic)  representa solo dos elementos del conjunto: fsBold y fsItalic.

Función MkSetRange

La función MkSetRange es un constructor de conjuntos con un rango de argumentos. Por ejemplo:

LayerSet := MkSetRange(eTopLayer,eBottomLayer);

La función MkSetRange(eTopLayer,eBottomLayer) representa un rango de capas desde eTopLayer hasta eBottomLayer.

Función InSet

La función InSet se utiliza como sustituto del operador In de Delphi. A in B equivale a InSet(A, B).

If InSet(A,B) then
  ShowMessage('A is in B set')
Else
  ShowMessage('A not in B set');

Función SetUnion

La función SetUnion se utiliza como sustituto del operador + de Delphi. A + B equivale a SetUnion(A, B).

ASet := BSet + CSet;
// should be changed to:
ASet := SetUnion(BSet,CSet);
// in order to achieve the desired script result.

Función SetDifference

La función SetDifference se utiliza como sustituto del operador - de Delphi. A - B equivale a SetDifference(A, B).

Función SetIntersection

La función SetIntersection se utiliza como sustituto del operador * de Delphi. A * B equivale a SetIntersection(A, B).

Función SubSet

La función SubSet se utiliza como sustituto del operador <= de Object Pascal. A <= B equivale a SubSet(A, B).

Uso de controladores de excepciones

La palabra clave Try introduce una instrucción Try-Except o una instrucción Try-Finally. Estas dos instrucciones están relacionadas, pero tienen propósitos distintos:

Try-Finally

Con Try-Finally, las instrucciones del bloque Finally siempre se ejecutan, independientemente de que se produzca una excepción en el bloque Try o se ejecute Exit o Break. Utilice el bloque Try-Finally para liberar objetos temporales y otros recursos, así como para realizar tareas de limpieza.

Normalmente, solo se necesita una instrucción 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 guardarlas en un registro de errores o crear un cuadro de diálogo fácil de entender. Dado que DelphiScript no admite la palabra clave On, se utiliza la instrucción Raise dentro del bloque Except.

Example:

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

Raise

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, dado que no se admite la palabra clave On, no se pueden utilizar los objetos Exception (disponibles en Embarcadero Delphi).

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