Funciones integradas

BrightScript incluye un conjunto de funciones intrínsecas integradas con alcance de módulo. También hay disponibles varias funciones de E/S de archivos, cadenas, matemáticas y sistema mediante el objeto roGlobal.

Type(a As Variable) As String 

Esta función devuelve el tipo de la variable y/u objeto pasado.

GetGlobalAA() As Object

Esta función obtiene el arreglo asociativo global para el script actual.

Rnd(range As Integer) As Integer Rnd(0) As Float

Si se pasa un entero positivo distinto de cero, esta función devuelve un entero pseudoaleatorio entre 1 y el valor del argumento. El rango incluye el valor del argumento: por ejemplo, llamar a Rnd(55) devolverá un entero pseudoaleatorio mayor que 0 y menor que 56.

Si el argumento es 0, esta función devuelve un valor Float pseudoaleatorio entre 0 y 1.

Box(type As Dynamic) As Object

Esta función devuelve una versión de objeto del tipo intrínseco especificado. Los objetos se pasarán sin modificaciones.

Ejecutar(file_name As String, [optional_arg As Dynamic, …]) As Dynamic Ejecutar(file_names As roArray, [optional_arg As Dynamic, …]) As Dynamic

Esta función ejecuta uno o más scripts desde el script actual. Puede agregar argumentos opcionales, que se pasarán a la función Main() de los scripts. El script llamado también puede devolver argumentos al script que realiza la llamada.

Si se pasa un nombre de archivo de cadena, la función compilará y ejecutará el archivo correspondiente. Si se pasa un arreglo de archivos, la función compilará cada archivo, los vinculará entre sí y los ejecutará.

Eval(code_snippet As String) As Dynamic

Esta función ejecuta el fragmento de código pasado en el contexto de la función actual. La función compila el fragmento y luego ejecuta el byte-code. Si el código se compila y ejecuta correctamente, devolverá cero. Si el código se compila correctamente, pero encuentra un error de tiempo de ejecución, devolverá un entero que indica el código de error (usando los mismos códigos que la función GetLastRunRuntimeError()). Si la compilación falla, devolverá un objeto roList; la estructura roList es idéntica a la de la función GetLastRunCompileError() .

La función Eval() puede ser útil en dos casos:

GetLastRunCompileError() As roList

Esta función devuelve un objeto roList que contiene errores de compilación (o Invalid si no ocurrieron errores). Cada entrada de roList es un objeto roAssociativeArray que contiene las siguientes claves:

Los siguientes son posibles valores de ERRNO :

GetLastRunRuntimeError() As Integer

Esta función devuelve el código de error que resultó de la última función Run().

Estos códigos indican un resultado normal:

Los siguientes códigos indican errores en tiempo de ejecución: