Funciones
De un vistazo
- 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.
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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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):
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Las rutinas de cadenas que not admite DelphiScript se detallan en la siguiente tabla:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
Useful functions:
|
|
|
|
|
|
|
|
|
Useful dialogs:
|
|
|
|
|
|
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 |
|---|---|
|
|
- |
|
* |
|
|
|
|
|
|
|
|
|
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).