Manual Básico

Gambas
 Índice
Referencia de Gambas
Descripciones del Lenguaje.
Índice Alfabético del Lenguaje
Componentes
Librerías
Índice del Lenguaje por Categorías
Índice alfabético del lenguaje

Tutoriales
Instalación (Librerías necesarias)
Lo más básico de Gambas
Interfaz gráfica
Varios
Aplicaciones en varios idiomas

Artículos Gambas
Diferencia entre VB
Como escribir componentes
Introducción Visual a Gambas
¿Cómo puedo convertir mi proyecto VB a Gambas?
¿Cómo se hace para… ?

Programación en N-capas Bajo Gambas

Un ejemplo de juego simple, “The Bisha”

Ejemplo de manejo de procesos, “GbPing”
Otro ejemplo de colaboración entre procesos, "GbPloticusDemo"
Descripciones del Lenguaje.

Asignación
Asigna el valor de una expresión a uno de los siguientes elementos:

• Una variable local.

• Un parámetro de una función.
• Una variable global o de clase.
• Un elemento de una matriz.
• Una variable pública de un objeto.
• Una propiedad de un objeto.

Algunas instrucciones que devuelven valores pueden emplear también la sintaxis de asignación: EXEC,
NEW, OPEN, RAISE, SHELL.

EJEMPLO
iVal = 1972
Name = "[/def/gambas]"
hObject.Property = iVal
cCollection[sKey] = Name
...

Constantes del Lenguaje

CONSTANTE EJEMPLO
El valor verdadero. TRUE

El valor falso. FALSE

Los números Integer o Long. 0, 123, -32769, 10000000000

Enteros hexadecimales cortos con signo. &H1F5, &HFFFF, &FFFF

Enteros hexadecimales con signo. &H10BF332E, &10BF332E

Enteros hexadecimales sin signo. &H8000&, &HFFFF&

Enteros binarios. &X1010010101, %101001011

Números de coma flotante. 1.0, -5.345219E+45

Constantes de Cadena. "¡ Hola, mundo !"

Constantes de Cadena para ser traducidas. ("¡Este programa está muy bien!")
Constante nula / cadena vacía. NULL
Las constantes de cadena pueden contener los siguientes caracteres de escape:

CARACTER DE ESCAPE EQUIVALENTE ASCII

\n Chr$(13)
\r Chr$(10)
\t Chr$(9)
\" Comillas
\\ Barra hacia atrás
\xx Chr$(&Hxx)

Puede escribir una constante de cadena dividida en varias partes sucesivas. Por ejemplo,

"Gambas" " es " "fenómeno"

es a todos los efectos la misma constante que
"Gambas es fenómeno"

Chr$
Sintaxis
Caracter = Chr$ ( Código )
Caracter = Chr ( Código )

Devuelve el caracter cuyo código ASCII es Código.

¡Precaución! Gambas utiliza UTF-8 como codificación interna, por lo que un caracter con código 128
o superior no tiene el mismo significado que en otras codificaciones, como ISO 8859-1.
Ejemplo

Ejemplo
PRINT Chr$(65)

PUBLIC SUB Button1_Click()

DIM X AS Integer

FOR X = 32 TO 127
PRINT Chr$(X);
NEXT

END
Constantes Predefinidas

Tipos de datos
Estas constantes son devueltas por TypeOf.

gb.Null valor NULL

gb.Boolean valor Boolean.
gb.Byte valor Byte.
gb.Short valor Short.
gb.Integer valor Integer.
gb.Long valor Long.
gb.Single valor Single.
gb.Float valor Float.
gb.Date valor Date.
gb.String valor String.
gb.Variant valor Variant.
gb.Object referencia Object.

gb (gb)
Esta clase estática incluye todas las constantes básicas de Gambas empleadas por un gran número de
funciones.
Símbolos
Esta clase es estática.

Constantes
Ascent BigEndian Binary Boolean Byte Class Currency Date Day Descent Device Directory
Exec File Fixed Float Friday GeneralDate GeneralNumber Hour Integer International Link
LittleEndian Long LongDate LongTime MediumDate MediumTime Minute Monday Month
NewLine Null Object Percent Pipe Quarter Read Saturday Scientific Second Short ShortDate
ShortTime Single Socket Standard String Sunday Tab Text Thursday Tuesday Variant
Wednesday Week WeekDay Write Year
Tipos de archivo
Estas constantes tiene uso en la función Stat().

gb.File Archivo normal

gb.Directory Carpeta
gb.Device Archivo especial de dispositivo
gb.Pipe Tubería con nombre
gb.Socket Archivo especial de Socket
gb.Link Enlace simbólico

Constantes de cadena
gb.NewLine Caracter de "Nueva Línea". Equivalente a Chr$(10)
gb.Tab Caracter de Tabulación. Equivalente a Chr$(9)

Tipos de ordenación
Constantes empleadas en el método Sort de las Matrices.

gb.Binary Ordenación binaria.

gb.Text Ordenación ASCII, no distingue mayúsculas de minúsculas.

Días de la semana
Estas constantes son valores devueltos por la función WeekDay().

gb.Monday Lunes
gb.Tuesday Martes
gb.Wednesday Miércoles
gb.Thursday Jueves
gb.Friday Viernes
gb.Saturday Sábado
gb.Sunday Domingo
Formatos numéricos predefinidos
gb.GeneralNumber Escribe en número con 12 dígitos decimales. Usa formato científico si su valor absoluto
es menor que 10-4 o mayor que 107.
gb.Fixed Equivalente a "0.00"
gb.Percent Equivalente a "###%"
gb.Scientific Escribe un número con su exponente y 8 dígitos decimales.

Formatos predefinidos de fecha y hora

gb.GeneralDate Escribe la fecha sólo si el dato de fecha y hora tiene una parte de fecha, y escribe la hora
sólo si tiene parte de hora.
gb.LongDate Formato de fecha larga.
gb.MediumDate Formato de fecha media.
gb.ShortDate Formato de fecha corta.
gb.LongTime Formato de hora larga.
gb.MediumTime Formato de hora media.
gb.ShortTime Formato de hora corta.

Formatos predefinidos monetarios

gb.Currency Formatea un dato monetario usando el símbolo nacional de la moneda.
gb.International Formatea un dato monetario usando el símbolo internacional de moneda.

Formatos misceláneos
gb.Standard Emplee gb.GeneralNumber para formatear números y gb.GeneralDate para fechas y horas.
Estructuras de Control de Bucles
BREAK Abandona un bucle inmediatamente.
CONTINUE Salta a la siguiente iteración de un bucle.
DO ... LOOP Bucle infinito.
FOR ... NEXT Bucle con contador.
FOR EACH ... NEXT Bucle de enumeración.

REPEAT ... UNTIL Bucle con una comprobación de salida al final.

WHILE ... WEND Bucle con una comprobación de salida al inicio.

BREAK
Sintaxis
BREAK
Abandona un bucle inmediatamente.

PUBLIC SUB Button1_Click()

DIM X AS Integer

FOR X = 1 TO 1000
IF X = 200 THEN BREAK
PRINT X
NEXT

END

CONTINUE
Sintaxis
CONTINUE
Salta a la siguiente iteración de un bucle.
Ejemplo
FOR I = 1 TO 10

IF I = 1 THEN
PRINT "Uno";
CONTINUE
ENDIF

IF I = 2 THEN
PRINT " Dos";
CONTINUE
ENDIF

PRINT I;

NEXT

PRINT

Uno Dos 3 4 5 6 7 8 9 10
DO
Sintaxis
DO [ WHILE Expresión ]
Comienza un bucle infinito delimitado por las instrucciones DO ... LOOP. Si se especifica WHILE, el bucle
se detendrá cuando la Expresión sea falsa. Si la expresión es falsa al comienzo, el bucle no se ejcuta ninguna
vez.
Ejemplo
PUBLIC SUB Form_Open()

DIM a AS Integer

a = 1

DO WHILE a <= 10
PRINT "Hola Mundo "; a
INC a
LOOP

END

FOR
Sintaxis
FOR Variable = Expresión TO Expresión [ STEP Expresión ]
...
NEXT
Repite un bucle mientras se incrementa una variable.
Tenga en cuenta que la variable ha de ser:
• Numérica, es decir, un byte, un short, un integer o un número real float o single.
• Una variable local.
Tenga en cuenta también que si la expresión inicial es mayor que la final (para valores positivos de STEP), o
es menor que la final (para valores negativos), el bucle nunca se ejecutará.

DIM I AS Integer

FOR I = 1 TO 20 STEP 3
PRINT I & " ";
NEXT

1 4 7 10 13 16 19

FOR EACH
Sintaxis
FOR EACH Variable IN Expresión
…
NEXT
Repite un bucle mientras se enumera un objeto.
Expresión debe ser una referencia a un objeto enumerable: por ejemplo, una colección, o una matriz.
Ejemplo
DIM Dict AS NEW Collection
DIM Elemento AS String

Dict["Azul"] = 3
Dict["Rojo"] = 1
Dict["Verde"] = 2

FOR EACH Elemento IN Dict

PRINT Elemento;
NEXT

3 1 2

REPEAT
Sintaxis
Sintaxis
REPEAT
Da comienzo a una estructura de bucle delimitada por las instrucciones REPEAT ... UNTIL.
Tenga en cuenta que el bucle repeat siempre se ejecuta al menos una vez, incluso si el valor indicado por
UNTIL es falso inicialmente.

UNTIL
Sintaxis
Sintaxis
UNTIL Expresión

Finaliza un bucle delimitado por las instrucciones REPEAT ... UNTIL.

El bucle se repite hasta que la Expresión es cierta.
Ejemplo
PUBLIC SUB Form_Open()

DIM I AS Integer

REPEAT
PRINT Timer
UNTIL Timer > 10

END

WHILE
Sintaxis
Sintaxis
WHILE Expresión
Da comienzo a un bucle delimitado por las instrucciones WHILE ... WEND.
El bucle se repite mientras la Expresión sea cierta.
Si la expresión es falsa al inicio, el bucle nunca se ejecuta.
La estructura DO WHILE ... LOOP es equivalente.
Ejemplo
PUBLIC SUB Form_Open()

DIM a AS Integer

a = 1

WHILE a <= 10
PRINT "Hola Mundo "; a
INC a
WEND

END
Estructuras de Control Misceláneas
GOTO Salto incondicional.
QUIT Cierra el programa.
RETURN Retorna de una función o procedimiento.
STOP Simula un punto de interrupción.
WITH ... END WITH Selector de objeto por defecto.

GOTO
Sintaxis
GOTO Etiqueta

Salta a una etiqueta declarada en otro punto de la función.

QUIT
Sintaxis
QUIT

Finaliza un programa inmediatamente.

Todas las ventanas se cerrarán, y todo se liberará lo mejor posible.

RETURN
Sintaxis
RETURN [ Expresión ]

Sale de un procedimiento o función devolviendo el valor Expresión.

Si sale de un procedimiento, no puede especificar ninguna Expresión.
Si sale de una función, y no se especifica la Expresión, el valor devuelto es el valor por defecto asociado al
tipo de dato devuelto por la función.

STOP
Sintaxis
STOP

Detiene el programa y lanza el depurador, del mismo modo que un punto de interrupción en la línea actual.
Esta instrucción no hace nada si el programa no está siendo depurado.
Ejemplo
'Parar si la siguiente condición se cumple
IF Name = "Gates" THEN STOP
WITH
Sintaxis
Sintaxis
WITH Objeto
...
END WITH
Entre las instrucciones WITH y END WITH, una expresión que comience por un punto se refiere al objeto.
Puede imbricar las estructuras WITH ... END WITH.

WITH hButton
.Text = "Cancelar"
END WITH

'es equivalente a

hButton.Text = "Cancelar"

Estructuras y Funciones de Control de Flujo

CHOOSE Elije un valor de una lista.
IIf Función de comprobación inmediata.
IF ... THEN ... ELSE ... ENDIF Estructura condicional.
SELECT CASE ... END SELECT Estructura de elección.

Choose

Sintaxis
Valor = Choose (Elección , Resultado #1 , Resultado #2 [ , ... ] )
Esta función devuelve el valor de uno de sus argumentos Resultado #i , de acuerdo con el valor de Elección.
• Si Elección es 1, se devuelve Resultado #1.
• Si Elección es 2, se devuelve Resultado #2, y así en adelante...
• Si Elección es menor o igual a cero, o no hay valor especificado para el valor de Elección, se
devuelve NULL.
Ejemplo
X = 3
PRINT Choose(X, "uno", "dos", "tres", "cuatro")

tres
Ejemplo
X = 3
PRINT IsNull(Choose(X * 2, "uno", "dos", "tres", "cuatro"))

True
IIf
Sintaxis
Value = IIf ( Boolean , True value [ , False value ] )
Value = If ( Boolean , True value [ , False value ] )

Evaluate the Boolean expression, and return True value if this expression is true, or False value if this
expression is false.

If False value is not specified, it is assumed to be NULL.

Be careful! Contrary to IF, or the C/Perl ? operator, both True value and False value are evaluated,
whatever the value of Boolean is.
Example
X = 7
PRINT If((X MOD 2) = 0, "even", "odd")

odd
Example
' Never do the following in real code, because it is not translatable!
X = 7
PRINT "You have " & X & " message" & If(X <> 1, "s") & " waiting."

You have 7 messages waiting.

Example
PRINT If((X MOD 2) = 1, "odd", 1 / 0)

Division by zero

IF
Sintaxis
IF Expresión [ { AND IF | OR IF } Expresión ... ] THEN
...
[ ELSE IF Expresión [ { AND IF | OR IF } Expresión ... ] THEN
... ]
[ ELSE
... ]
ENDIF
Estructura condicional de control.
Si utiliza varias expresiones de comprobación separadas por la palabra clave AND IF, son evaluadas de
izquierda a derecha hasta que la primera con valor FALSE es alcanzada, y se considera entonces el conjunto
con valor FALSE. Si todas las expresiones son TRUE, el conjunto se considera con valor TRUE.
Si utiliza varias expresiones de comprobación separadas por la palabra clave OR IF, son evaluadas de
izquierda a derecha hasta que la primera con valor TRUE es alcanzada, y se considera entonces el conjunto
con valor TRUE. Si todas las expresiones son FALSE, el conjunto se considera con valor FALSE.
No se puede mezclar las palabras clave AND IF y OR IF en una misma línea.
DIM k AS Integer

FOR k = 1 TO 10

IF k < 5 OR IF k > 5 THEN

PRINT k;;
ELSE
PRINT
PRINT "¡Llegamos al 5!"
END IF

NEXT

PRINT

1 2 3 4
¡Llegamos al 5!
6 7 8 9 10

SELECT
s
Sintaxis
SELECT [ CASE ] Expresión

[ CASE Expresión [ TO Expresión #2 ] [ , ... ]

... ]

[ CASE Expresión [ TO Expresión #2 ] [ , ... ]

... ]

[ { CASE ELSE | DEFAULT }

... ]

END SELECT
Selecciona una expresión a comparar, y ejecuta el código encerrado en la expresión correspondiente CASE.
Si no concuerda ninguna de las expresiones CASE, se ejecutará el código dentro de la expresión DEFAULT
o CASE ELSE.
Una expresión CASE es una lista de valores simples o intervalos entre dos valores separados por la palabra
clave TO.
Ejemplo
'Desea calcular una función aleatoria.
'Repite una función aleatoria mil veces para
'conocer cuantas veces aparecen los números
'1, 2, 3, 4, 5 o 6.

DIM x AS Integer
DIM w AS Integer
DIM a AS Integer
DIM b AS Integer
DIM c AS Integer
DIM d AS Integer
DIM e AS Integer
DIM f AS Integer
FOR x = 1 TO 1000

w = Int(Rnd(6) + 1)

SELECT CASE w
CASE 1
a = a + 1
CASE 2
b = b + 1
CASE 3
c = c + 1
CASE 4
d = d + 1
CASE 5
e = e + 1
CASE 6
f = f + 1
CASE ELSE
PRINT "¡Esto es imposible!"
END SELECT

NEXT

PRINT a, b, c, d, e, f

Flujos y funciones de Entrada/Salida

CLOSE Cierra un Flujo
EOf Devuelve un valor indicando si se alconzó el final de un archivo.
FLUSH Vuelca la salida de un Flujo que dispone de un buffer.
INPUT Lee cadenas de un Flujo de texto y las convierte en valores.
INPUT FROM Redirige la entrada estándar.
LINE INPUT Lee líneas de un Flujo de texto.
LOCK Bloquea un Flujo abierto.
LOf Devuelve la longitud de un Flujo.
OPEN Abre un archivo para lectura o escritura y crea un Flujo.
OUTPUT TO Redirige la salida estándar.
PRINT Escribe expresiones en un Flujo.
READ Lee datos binarios de un Flujo.
SEEK Cambia la posición del puntero de un Flujo.
SEEk Obtiene la posición del puntero de un Flujo.
UNLOCK Desbloquea un Flujo abierto.
WRITE Escribe datos binarios en un Flujo.
CLOSE
Sintaxis
Sintaxis
CLOSE [ # ] Flujo

Cierra un archivo abierto, u otro tipo de Flujo.

Esta instrucción nunca falla.
Si ha abierto un Flujo de proceso, cerrarlo significa cerrar la entrada estándar, similar a pulsar CTRL+D
en un terminal.

Eof
Sintaxis
Sintaxis
Booleano = Eof ( [ Flujo ] )

Devuelve TRUE si el puntero se encuentra al final de un flujo.

Si no se especifica Flujo, se emplea la entrada estándar.
Véase LINE INPUT para un ejemplo.

FLUSH
Sintaxis
Sintaxis
FLUSH [ [ # ] Flujo ]

Fija el contenido de un flujo que dispone de un buffer.

Si no se especifica el buffer, todos los flujos abiertos son fijados.
Fijar el contenido de un flujo abierto para lectura no tiene sentido.

INPUT
Sintaxis
Sintaxis
INPUT [ # Flujo , ] Variable [ , Variable ... ]

Lee el Flujo, y convierte elementos separados por caracteres de espacio o retornos de carro con la función
Val antes de situar el valor en las variables.
Si no se especifica el flujo, se lee de la entrada estándar.
INPUT FROM
Syntax
Sintaxis
INPUT FROM Stream

Redirects the default standard input to the stream Stream.

The default standard input is used by INPUT, READ, LINE INPUT, Eof and Lof when you don't specify
their stream argument.
Calls to this instruction can be imbricated.
Syntax
INPUT FROM DEFAULT
Redirects the default standard input back to the value it had before the last redirection

LINE INPUT
Sintaxis
LINE INPUT [ # Flujo , ] Variable
Lee una línea entera de texto del flujo indicado.
Si no se especifica un flujo, se utilizará la entrada estándar.
No emplee esta instrucción para leer desde archivos binarios, ya que perderá los caracteres de retorno de
carro. Emplee READ en su lugar.
Ejemplo
'Muestra un archivo en la consola

hFile = OPEN NombreArchivo FOR INPUT

WHILE NOT Eof(hFile)

LINE INPUT #hFile, UnaLinea
PRINT UnaLinea
WEND

CLOSE #hFile

LOCK
Sintaxis
Sintaxis
LOCK [ # ] Flujo
Intenta dar de alta un bloqueo de sistema en un flujo abierto.
Si el flujo ya está bloqueado por otro proceso, el comando falla.

Lof
Sintaxis
Longitud = Lof ( Flujo AS Stream )

Devuelve la longitud de un flujo abierto.

OPEN NombreArchivo FOR READ AS #hFile
...
PRINT "La longitud del archivo es: "; Lof(hFile)

Si el flujo no es un archivo, es decir, un objeto Process o un Socket, retorna el número de bytes que pueden
ser leídos de una sola vez.

PUBLIC SUB Process_Read()

DIM sBuffer AS String

PRINT "Puedo leer: "; Lof(LAST)

' Read them
READ #LAST, sBuffer, Lof(LAST)

END

OPEN
x
Sintaxis
Stream = OPEN File name FOR [ READ | INPUT ] [ WRITE | OUTPUT ] [ CREATE | APPEND ] [
WATCH ]

Opens a file for reading, writing, creating or appending data. The file must exist, unless the CREATE keyword
is specified.

• If the CREATE keyword is specified, then the file is created, or cleared if it already exists.
• If the APPEND keyword is specified, then the file pointer is moved to the end of file just after the file is
opened.
• If the READ or WRITE keyword are specified, then the input-output are not buffered.
• If the INPUT or OUTPUT keyword are specified, then the input-output are buffered.
• If the WATCH keyword is specified, the file is watched by the interpreter :
o If at least one byte can be read from the file, then the event handler File_Read() is called.
o If at least one byte can be written into the file, then the event handler File_Write() is called.

If the file is successfully opened, a stream object is returned to the variable Stream.
Errors

MESSAGE DESCRIPTION
Access forbidden The requested access to the file is not allowed, or search permission is denied for one of
(#43) the directories in the path prefix of pathname, or the file did not exist yet and write
access to the parent directory is not allowed.
File is a directory File name refers to a directory.
(#46)
File or directory File name does not exist, or a directory component in pathname does not exist or is a
does not exist (#45) dangling symbolic link.
Out of memory The system ran out of memory.
(#1)
Device is full (#37) File name was to be created but the device containing File name has no room for the
new file.
Not a directory... A component used as a directory in File name is not, in fact, a directory.
(#49)
System error... Other possible system errors:
(#42)
• Too many symbolic links were encountered in resolving File name.
• The process already has the maximum number of files open.
• The system limit on the total number of open files has been reached.
• File name refers to a device special file and no corresponding device exists.
• The named file is a named pipe and no process has the file open for reading.
• File name refers to a file on a read-only filesystem and write access was
requested.
• File name refers to an executable image which is currently being executed and
write access was requested.

Example
' Prints the contents of a text file to the screen

DIM hFile AS File

DIM sLine AS String

hFile = OPEN "/etc/passwd" FOR INPUT

WHILE NOT Eof(hFile)

LINE INPUT #hFile, sLine
PRINT sLine
WEND
Example
' Watching a serial port

DIM hFile AS File

hFile = OPEN "/dev/ttyS0" FOR READ WRITE WATCH

...

PUBLIC SUB File_Read()

DIM iByte AS Byte

READ #hFile, iByte

PRINT "Got one byte: "; iByte

END
Example
' Reading data from a BMP file, known to use little-endian format :

DIM hFile AS File

DIM iData AS Integer

hFile = OPEN "image.bmp" FOR INPUT

hFile.ByteOrder = gb.LittleEndian
...
READ #hFile, iData
OUTPUT TO
Sintaxis
OUTPUT TO Flujo
Redirige la salida estándar por defecto al flujo indicado.
La salida estándar por defecto se utiliza por parte de PRINT y WRITE si no especifica el argumento de flujo.
Las llamadas a esta función pueden imbricarse.
Sintaxis
OUTPUT TO DEFAULT
Redirige la salida estándar de nuevo hacia el valor previo a la redirección.

PRINT
Sintaxis
Sintaxis
PRINT [ # Flujo , ] Expresión [ { ; | ;; | , } Expresión ... ] [ { ; | ;; | , } ]

Escribe expresiones en el flujo.

Si no se especifica un flujo, se utilizará la salida estándar.
Las expresiones se convierten en cadenas empleando la función Str$.
• Si no hay un punto y coma después de la expresión, se añade un caracter de "nueva línea" después de
la última expresión.
• Si hay un punto y coma doble, se añade un caracter de "espacio" entre las expresiones.
• Si se utiliza una coma en lugar de un punto y coma, se añade un caracter de tabulación (código 9
ASCII) para separar las expresiones.

READ
Syntax
Sintaxis
READ [ # Stream , ] Variable [ , Length ]
READ [ # Pointer , ] Variable [ , Length ]
Reads the stream Stream as binary data whose type is given by the type of the variable. The binary
representation is the one used by the WRITE instruction.
If the stream is not specified, then the standard input is used.
If Variable is a string, you can specify a length that indicates the number of bytes to read. If the length is
negative, then (- Length) bytes are read up to the end of stream.
If no length is specified for a string, it is is read from the stream. The string then must have been written with
the WRITE instruction.

This instruction uses the byte order of the stream to read the data.

If you specify a Pointer instead of a Stream, then data will be read directly from the memory address
specified by the pointer.

If you try to read at a forbidden memory address, you will get an error. The interpreter won't crash.
SEEK
Syntax
Sintaxis
SEEK [ # ] Stream , Position

Defines the position of the stream pointer, for the next read/write operation.
If Position is negative, then the stream pointer is moved relatively to the end of the file.
To move the stream pointer after the end of the file, you must use the Lof function.
Example
' Move to the beginning of the file
SEEK #hFile, 0

' Move after the end of the file

SEEK #hFile, Lof(#hFile)

' Move 100 bytes before the end of the file

SEEK #hFile, -100

Seek
Sintaxis
Sintaxis
Posición = Seek ( Flujo )

Devuelve el valor actual del puntero en el flujo indicado.

El valor devuelto es un entero largo.

Muchos tipos de flujos no disponen de un puntero: Process, Socket, ...

UNLOCK
Sintaxis
Sintaxis
UNLOCK [ # ] Flujo

Desbloquea un Flujo previamente bloqueado con la instrucción LOCK.

WRITE
Sintaxis
WRITE [ # Flujo , ] Expresión [ , Longitud ]
WRITE [ # Puntero , ] Expresión [ , Longitud ]

Escribe una expresión en un Flujo usando su representación binaria.

Si no se especifica el flujo, se emplea la salida estándar.

Si la Expresión es una cadena, puede especificar la longitud que indica el número de bytes a escribir. Si no se
especifica la longitud, éste se escribe en el flujo justo antes de la cadena de datos.

Esta función emplea el orden de bytes del flujo para leer datos.

Si especifica un puntero en lugar de un flujo, los datos serán escritos directamente en la dirección de
memoria especificada por el puntero.

Si intenta escribir en una dirección de memoria prohibida, obtendrá un error. El intérprete no fallará.

Funciones Aritméticas
Abs Devuelve el valor absoluto de un número.
DEC Decrementa una variable.
Frac Devuelve la parte fraccional de un número.
INC Incrementa una variable.
Int Devuelve la parte entera de un número.
Max Devuelve el número mayor.
Min Devuelve el número menor.
Round Redondea un número.
Sgn Devuelve el signo de un número.

Funciones de Cadena
Asc Devuelve el código ASCII de un carácter en una cadena.
Chr$ Devuelve un carácter a partir de su código ASCII.
InStr Busca una cadena dentro de otra.
LCase$ Convierte una cadena a minúsculas.
Left$ Devuelve los primeros caracteres de una cadena.
Len Devuelve la longitud de una cadena.
LTrim$ Elimina espacios en blanco de la parte inicial de una cadena.
Mid$ Devuelve parte de una cadena.
Replace$ Reemplaza, dentro de una cadena, una subcadena por otra.
Right$ Devuelve los últimos caracteres de una cadena.
RInStr Busca una cadena dentro de otra empezando por su final.
RTrim$ Elimina espacios en blanco de la parte final de una cadena.
Space$ Devuelve una cadena que contiene sólo espacios.
Split Divide una cadena en subcadenas.
String$ Devuelve la misma cadena concatenada varias veces.
Subst$ Sustituye cadenas en un patrón.
Trim$ Elimina espacios en blanco del final de una cadena.
UCase$ Convierte una cadena a mayúsculas.

Funciones de Conversión
CBool Convierte un valor en Boolean.
CByte Convierte un valor en Byte.
CDate Convierte un valor en Date.
CFloat Convierte un valor en Float.
CInt Convierte un valor en Integer.
CLong Convierte un valor en Long.
Conv$ Convierte una cadena de un juego de caracteres a otro.
CShort Convierte un valor en Short.
CSng Convierte un valor en Single.
CStr Convierte un valor en String.
DConv$ Convierte una cadena del juego de caracteres del sistema a UTF-8 (juego de caracteres de la interfaz
gráfica).
SConv$ Convierte una cadena desde el juego de caracteres UTF-8 (el empleado en la interfaz gráfica) al
juego de caracteres del sistema.
Str$ Convierte un número o fecha en una cadena.
Val Convierte una cadena en un número o fecha.

Funciones de Fecha y Hora

Date Devuelve la fecha sin el componente de hora.
DateAdd Añade un periodo de tiempo a la fecha dada.
DateDiff Devuelve el periodo de tiempo entre dos fechas.
Day Devuelve el día de un valor Date.
Hour Devuelve el número de horas de un valor Date.
Minute Devuelve el número de minutos de un valor Date.
Month Devuelve el número de mes de un valor Date.
Now Devuelve la fecha y hora actuales.
Second Devuelve los segundos de un valor Date.
Time Devuelve la parte de hora de un valor Date.
Timer Devuelve el número de segundos transcurridos desde que se inició el programa.
Week Devuelve el número de semana de un valor Date.
WeekDay Devuelve el número de día en la semana de un valor Date.
Year Devuelve el año de un valor Date.

Funciones de Formateo
Bin$ Formatea un número en binario.
Format$ Formatea un número o fecha.
Hex$ Formatea un número en hexadecimal.

Funciones Misceláneas
Array Crea y devuelve una matriz.

Funciones para Archivos y Carpetas

Access Comprueba los permisos de acceso a un archivo.
COPY Copia un archivo.
DFree Devuelve el espacio libre en un dispositivo.
Dir Devuelve el contenido de una carpeta.
IsDir Devuelve si la ruta apunta a una carpeta.
KILL Elimina un archivo.
LINK Crea un enlace simbólico.
MKDIR Crea una carpeta.
RDir Devuelve el resultado de una carpeta recursivamente.
RENAME Renombra o mueve un archivo o carpeta.
RMDIR Elimina una carpeta vacía.
Stat Obtiene información sobre un archivo.
Temp$ Crea nombres de archivos temporales.

Funciones para Comprobar Caracteres

IsAscii Comprueba si una cadena contiene sólo caracteres ASCII.
IsBlank Comprueba si una cadena contiene sólo caracteres de espacio o tabulaciones.
IsDigit Comprueba si una cadena contiene sólo dígitos.
IsHexa Comprueba si una cadena contiene sólo dígitos hexadecimales.
IsLCase Comprueba si una cadena contiene sólo letras minúsculas.
IsLetter Comprueba si una cadena contiene sólo letras.
IsPunct Comprueba si una cadena contiene sólo caracteres no alfanuméric
IsSpace Comprueba si una cadena contiene sólo caracteres de espacio.
IsUCase Comprueba si una cadena contiene sólo letras mayúsculas.

Funciones para Tipos de Datos

IsBoolean Devuelve si una expresión pertenece al tipo Boolean.
IsByte Devuelve si una expresión pertenece al tipo Byte.
IsDate Devuelve si una expresión pertenece al tipo Date.
IsFloat Devuelve si una expresión pertenece al tipo Float.
IsInteger Devuelve si una expresión pertenece al tipo Integer.
IsLong Devuelve si una expresión pertenece al tipo Long.
IsNull Devuelve si una expresión es nula (NULL).
IsNumber Devuelve si una expresión es un número.
IsObject Devuelve si una expresión pertenece al tipo Object.
IsShort Devuelve si una expresión pertenece al tipo Short.
IsSingle Devuelve si una expresión pertenece al tipo Single.
IsString Devuelve si una expresión pertenece al tipo String.
TypeOf Devuelve el tipo de valor de una expresión.

Funciones Sobre Números Aleatorios

Randomize Inicializa la semilla de generación de números pseudo aleatorios.
Rnd Devuelve un número pseudo aleatorio.

Funciones Trigonométricas
ACos Calcula el arcocoseno de un número.
ACosh Calcula el arcocoseno hiperbólico de un número.
Ang Calcula la coordenada "ángulo polar" para dos coordenadas cartesianas.
ASin Calcula el el arcoseno de un número.
ASinh Calcula el arcoseno hiperbólico de un número.
ATan Calcula la arcotangente de un número.
ATan2 Calcula la arcotangente de dos números.
ATanh Calcula la arcotangente hiperbólica de un número.
Cos Calcula el coseno de un ángulo.
Cosh Calcula el coseno hiperbólico de un ángulo.
Deg Convierte radianes a grados.
Hyp Calcula la hipotenusa de un triángulo.
Mag Calcula la coordenada "distancia polar" para dos coordenadas cartesianas.
Pi Devuelve π o un múltiplo de π.
Sin Calcula el seno de un ángulo.
Sinh Calcula el seno hiperbólico de un ángulo.
Tan Calcula la tangente de un ángulo.
Tanh Calcula la tangente hiperbólica de un ángulo.
Rad Convierte grados en radianes.

Funciones acerca de Logarítmos y Exponentes

Cbr Raíz cúbica
Exp Exponente
Exp2 2^x
Exp10 10^x
Expm Exp(x) - 1
Log Logaritmo neperiano
Log2 Logaritmo en Base 2
Log10 Logaritmo decimal
Logp Log(1+x)
Sqr Raíz cuadrada

Gestión de errores
CATCH Captura un error en una función.
DEBUG Muestra en consola un mensaje de depuración.
ERROR Indica si ocurrión un error, o muestra un mensaje de error.
Error La clase estática Error.
FINALLY Ejecuta un bloque de código en una función, incluso si hubo un error.
TRY Intenta ejecutar una orden, sin disparar un error.
Gestión de Eventos
EVENT Declara un evento.
RAISE Dispara un evento.
Object.Attach Enlaza un evento con su gestor de eventos.
Object.Detach Separa un evento de su gestor de eventos.
STOP EVENT Cancela un evento.
WAIT Llama al lazo de eventos hasta que haya pasado un tiempo indicado.

Gestión de Funciones Externas

Alloc Reserva un bloque de memoria.
EXTERN Declara una función externa.
Free Libera un bloque de memoria reservado con Alloc.
LIBRARY Define la librería donde se sitúan las funciones externas.
Realloc Recorta o expande el bloque de memoria reservado con Alloc.
StrPtr Devuelve una copia de una cadena terminada en cero, situada en la dirección de memoria dada.

Gestión de Objetos y Clases

CLASS Declara el uso de una clase.
Class Gran cantidad de métodos estáticos para obtener información de una clase.
CREATE Declara una clase como "auto-instanciable".
EXPORT Declara una clase como exportada.
INHERITS Hace que una clase herede de otra sus propiedades, métodos y eventos.
LAST Devuelve una referencia al último objeto que ha disparado un evento.
ME Devuelve una referencia al objeto actual.
NEW Instancia un objeto.
New Instancia un objeto con una clase que se especifica dinámicamente.
Object Gran cantidad de métodos estátios relativos a la gestión de un objeto.
SUPER Devuelve una referencia al objeto actual que utilizará la implementación de los símbolos públicos
de la clase padre.
Gestión de Procesos
EXEC Ejecuta un proceso externo.
SHELL Ejecuta un comando externo en una shell.

Lazo de Eventos
Cuando un programa Gambas ha terminado de ejecutar su función de inicio Main(), entra en el llamado lazo
de eventos o event loop.

El programa se encontrará dentro de este lazo o bucle mientras haya:

• un Process corriendo.
• un Timer habilitado.
• un File siendo vigilado.
• una ventana abierta.

En este lazo, el programa procesará cualquier evento disparado por cualquier objeto, y para cada evento,
llamará a su correspondiente /def/eventhandler.

Puede llamar de forma recursiva al lazo de eventos usando la instrucción WAIT. Esto puede conllevar una
recursión infinita, pero es el único modo de refrescar la interfaz de usuario durante la ejecución de un bucle.

Matrices Nativas
Gambas dispone de un tipo predefinido de matriz para cada tipo de datos nativo.

El nombre de estas clases es el nombre del tipo de datos que almacenan seguido de un corchete abierto y otro
cerrado.

Byte[] Matriz de valores Byte.

Short[] Matriz de valores Short.
Integer[] Matriz de valores Integer.
Long[] Matriz de valores Long.
Single[] Matriz de valores Single.
Float[] Matriz de valores Float.
Date[] Matriz de valores Date.
String[] Matriz de valores String.
Object[] Matriz de valores Object.
Variant[] Matriz de valores Variant.
Native Container Classes
Gambas interpreter offers you three kinds of native container classes:

Arrays
An Array is a set of values indexed by an Integer that are consecutive in memory.

All the values in an array have the same datatype, and there is one array class for each native datatype, except
Boolean.

See Native Arrays for more information.

Array can be multi-dimensional, i.e. values are indexed by more than one Integer.

If an array has one dimension, then it can be shrinked or expanded dynamically, with the Resize method.

Lists
A List is a double-linked list of values indexed by an Integer, each one being stored separately in memory.

Only Variant values can be stored in a List.

The List maintains a internal pointer so that finding a position in the list does not imply iterates all the
elements.

Collections
A Collection is a set of values indexed by a String.

Only Variant values can be stored in a Collection.

The values are internally stored in a hash table that grows dynamically when more and more elements are
inserted in it.

Which one use ?

Here is a short comparison between the three kind of container classes:

Array List Collection

Internal storage Memory block. Double linked-list. Hash table.
Key datatype Integer Integer String
Access Fastest Fast Fast
speed
The access is immediate. Accessing the first, last, The key must be compared
previous or next element is with all other keys having
immediate. Otherwise the list the same hash code.
is enumerated.
Insertion Slow Fastest Fast
speed
The memory block is resized if Once the position is found, the The key hash code gives a
needed. And inserting in the insertion is immediate. index into a linked list of
middle of the array needs moving memory slots.
part of the memory block.
The hash table have to be
resized and recalculated
sometimes to keep the
access fast.
Deletion Slow Fastest Fast
speed
The memory block is resized if Once the element is found, the Once the element is found,
needed. And deleting in the middle deletion is immediate. the deletion is immediate.
of the array needs moving part of
the memory block. The hash table have to be
resized and recalculated
sometimes to keep the
access fast.

Operadores Aritméticos
Numero + Numero Suma dos números.
- Numero Calcula el signo opuesto de un número. El opuesto de cero es cero.
Numero - Numero Resta dos números.
Numero * Numero Multiplica dos números.
Numero / Numero Divide dos números. Un error División por cero (#26) ocurrirá si el valor del divisor es
cero.
Numero ^ Potencia Eleva Numero a la Potencia indicada.

Por ejemplo, 4 ^ 3 = 64
Numero \ Numero Calcula el cociente de la división de dos números. Un error División por cero (#26)
ocurrirá si el valor del divisor es cero.
Numero DIV Numero
A \ B = Int(A / B)

Numero MOD Numero Calcula el resto de la división de dos números. Un error División por cero (#26)
ocurrirá si el valor del divisor es cero.
Operadores de Asignación
Variable = Expresión Asignación directa.
Variable += Expresión Asignación con suma.
Es un sinónimo de
Variable = Variable + Expresión
Variable -= Expresión Asignación con sustracción.
Es un sinónimo de
Variable = Variable - Expresión
Variable *= Expresión Asignación con multiplicación.
Es un sinónimo de
Variable = Variable * Expresión
Variable /= Expresión Asignación con división.
Es un sinónimo de
Variable = Variable / Expresión
Variable \= Expresión Asignación con división entera.
Es un sinónimo de
Variable = Variable \ Expresión
Variable &= Expresión Asignación con concatenación de cadenas.
Es un sinónimo de
Variable = Variable &= Expresión
Variable &/= Expresión Asignación con concatenación de rutas.
Es un sinónimo de
Variable = Variable &/= Expresión

Operadores de Cadena
Cadena & Cadena Concatena dos cadenas.
Cadena &/ Concatena dos cadenas que contienen nombres de archivo. Añade un separador de ruta
Cadena entre dos cadenas si es necesario.
Cadena LIKE Comprueba si una cadena concuerda con un patrón.
Numero

Operadores Lógicos
Número AND Número Calcula el "y lógico" del valor binario de dos números.
NOT Número Calcula el "no lógico" del valor binario de un número.
Número OR Número Calcula el "o lógico" del valor binario de dos números.
Número XOR Número Calcula el "o exclusivo lógico" del valor binario de dos números.
Tipos de Datos
Tipo de Valor por Tamaño en
Descripción
dato defecto memoria
Boolean Verdadero o falso. FALSE 1 byte
Byte 0...255 0 1 byte
Short -32.768...+32.767 0 2 bytes
Integer -2.147.483.648...+2.147.483.647 0 4 bytes
Long -9.223.372.036.854.775.808...+9.223.372.036.854.775.807 0 8 bytes
Single Como el tipo float de C. 0.0 4 bytes
Float Como el tipo double de C. 0.0 8 bytes
Date Fecha y hora, cada una almacenada en un entero. NULL 8 bytes
String Una cadena con un número variable de caracteres. NULL 4 bytes
Variant Cualquier tipo de dato. NULL 12 bytes
Object Referencia anónima a un objeto. NULL 4 bytes
Pointer Una dirección de memoria. 0 4 bytes
gb.compress - Librería de compresión
Este componente permite comprimir y descomprimir archivos, así como leer y escribir en archivos
comprimidos utilizando los métodos habituales en flujos. También permite comprimir y descomprimir
cadenas en memoria.

Actualmente, el componente puede utilizar dos algoritmos, gracias a las librerías zlib y libbzip2. Los
programas más conocidos que utilizan estos algoritmos son las utilidades de línea de comandos "gzip" y
"bzip2", por lo que podrá utilizar archivos generados por estas utilidades.

Este componente emplea internamente las librerías "libz" y "libbz2", por lo que debe tenerlas instaladas en
los equipos que hagan uso del componente de compresión. Si sólo desea utilizar uno de los dos algoritmos,
no es necesario que instale ambas librerías.

Más información sobre el funcionamiento interno:

http://www.gzip.org/zlib/
http://sources.redhat.com/bzip2/

Todas las distribuciones habituales de GNU/Linux incluyen paquetes con estas librerías, FreeBSD y otros
sistemas Unix, también. Ambos compresores están libres de patentes, y actualmente pueden ser utilizados
incluso en programas que no sean "código abierto" u "open source", si sigue todas las instrucciones
contenidas en sus licencias (léalas detenidamente para las versiones que planee utilizar).
Clases
/comp/gb.compress/compress
/comp/gb.compress/uncompress

gb.db - Componente para Acceso a Bases de Datos

Este componente le permite acceder a varios sistemas gestores de bases de datos.
Clases
Connection
DB
/comp/gb.db/database
/comp/gb.db/field
/comp/gb.db/index
/comp/gb.db/result
/comp/gb.db/resultfield
/comp/gb.db/table
/comp/gb.db/user

Este componente le permite acceder a los siguientes sistemas gestores de bases de datos:

• PostgreSQL
• MySQL
• SQLite
• ODBC
Tanto PostgreSQL como MySQL son sistemas de bases de datos cliente/servidor, lo que significa que la
conexión se realiza sobre un proceso servidor.

Por el contrario, SQLite está basado en un archivo o datos en memoria, por lo que no hay proceso servidor al
que conectarse. This means that the user may need to include a fully qualified path to the database file if the
default is not satisfactory. See the Connection class for more information.

Note that this component creates an intermediate layer between the specific server and your program, so that
you can use exactly the same code whatever database backend you decide to use.

This works only if:

• You create your database by using the database manager or by using this component.
• You use the /comp/db/find, /comp/db/create and /comp/db/edit methods.
• You don't put SQL values directly in the request, but use the substitution feature of the previous
methods.
• You don't use the /comp/db/exec method, that lets you send SQL request directly to the backend, so
that you can access its the specific features.

If you don't need database independance, do as you like!

gb - Clases nativas internas de Gambas

Este componente contiene todas las clases incluídas dentro del intérprete por defecto.
Clases
Application Object[]
/comp/gb/boolean[] Param
Byte[] Process
Class Short[]
/comp/gb/classes Single[]
Collection /comp/gb/stat
/comp/gb/component Stream
/comp/gb/components String
Date[] String[]
/comp/gb/enum System
Error User
File Variant[]
Float[] gb
Integer[]
Long[]
Object
Application (gb)
Esta clase entrega información acerca de la aplicación que está ejecutándose, y dota de acceso al entorno del
proceso así como a la línea de comandos del proceso.
Símbolos
Esta clase es estática.

Propiedades
Args /comp/gb/application/dir /comp/gb/application/env /comp/gb/application/handle
/comp/gb/application/id /comp/gb/application/name /comp/gb/application/path
/comp/gb/application/title /comp/gb/application/version

Byte[] (gb)
Esta clase implementa una matriz dinámica de valores Byte.
Símbolos
Esta clase proviene de .Array.

Esta clase es Instanciable.

Esta clase actúa como una matriz Lectura/escribir.
Esta clase es enumerable con la palabra clave FOR EACH.

Propiedades Métodos
/comp/gb/.array/bounds Count Data Add Clear Copy /comp/gb/byte[]/fill Find Insert Pop
/comp/gb/.array/dim Length Max Push Read Remove Resize Reverse Sort Write

Class (gb)
This class depicts a class used by the interpreter.

This class can be native, i.e. implemented in a component, or a class written in Gambas.
Símbolos
Esta clase no es instanciable.
Esta clase actúa como una matriz Sólo lectura.

Propiedades Métodos Constantes

/comp/gb/class/count /comp/gb/class/load /comp/gb/class/constant
/comp/gb/class/hidden /comp/gb/class/event
/comp/gb/class/instance /comp/gb/class/method
/comp/gb/class/name /comp/gb/class/property
/comp/gb/class/native /comp/gb/class/variable
/comp/gb/class/parent
/comp/gb/class/symbols
Collection (gb)
Implementa una tabla hash (en la cual se pueden buscar rápidamente pares clave-valor), en la que los
elementos tienen una clave de tipo cadena y los valores son de tipo variant.

Cuando no hay nada asociado a una clave, se emplea el valor NULL. En consecuencia, asociar el valor
NULL con una clave, tiene el mismo efecto que eliminarlo de la colección.

El tamaño de la tabla hash interna crece automáticamente al insertar datos.

Símbolos
Esta clase es Instanciable.
Esta clase actúa como una matriz Lectura/escribir.
Esta clase es enumerable con la palabra clave FOR EACH.

Propiedades Métodos
Count Key Length Add Clear Exist Remove