Manual de usuario en espaol de

AndroBasic for Android

versin 001
Jordi Sorroche Prez
jsptron@gmail.com
Barcelona Agosto 2013

Qu es AndroBasic?
Es un intrprete del lenguaje de programacin Basic
(Beginners All-purpose Symbolic Instruction Code)
especialmente diseado para tabletas con una resolucin en
pantalla de 1280 x 800 pxeles y sistema operativo Android.

Funcionamiento y entorno de programacin

de AndroBasic:
Al ejecutar AndroBasic nos aparecer la pantalla del editor
con fondo azul y con la subrutina SUB MAIN/END SUB-
indicndonos que podemos comenzar a programar.
En la parte superior derecha tenemos unos iconos junto con un
men desplegable con las siguientes opciones:

New:
Se crea un nuevo programa.

Undo:
Deshace el ltimo cambio realizado en el editor.

Redo:
Rehace el ltimo cambio realizado en el editor.

Run:
Pulsaremos sobre esta opcin para ejecutar el programa que
se halle en ese momento en el editor.
Load Program:
Permite cargar un programa desde la tarjeta SD -interna-
instalada en nuestra Tableta a la memoria del dispositivo.
Tambin podemos importar un programa desde el correo
electrnico. Para ello, abrimos el e-mail en concreto,
guardamos el archivo adjunto (el programa) y lo guardamos en
la ubicacin (//SD/AndroBasic_Programs), as de simple.

Save Program:
Con esta opcin, podremos guardar el programa que hallamos
creado en la tarjeta SD-interna- de nuestra Tableta.
Tambin podemos exportar el programa mediante el correo
electrnico.
Para ello, nos vamos a la opcin de archivos en le men de
Android- (en la ubicacin //SD/AndroBasic_Programs) .
Escogemos el que nos interesa, y le damos la opcin
compartir-enviar correo Elec.., como archivo adjunto, as de
sencillo.

Change Time Process:

Nos brinda la posibilidad de cambiar el tiempo de proceso en la
ejecucin de un programa -en milisegundos- entre instruccin e
instruccin. Por defecto, viene parametrizado con valor de 10,
pudindose cambiar este valor a un mnimo de 1 y un mximo
de 2000 ( 2 segundos). Es importante remarcar que no se debe
abusar de tiempos realmente cortos, ya que nuestro dispositivo
tiene que procesar otras tareas aparte de las nuestras, y que
esto puede conllevar al mal funcionamiento del programa. Sin
contar del sobrecalentamiento y a un consumo excesivo de la
batera.

Help:
Tutorial del funcionamiento del programa en ingls/espaol.

About:
Acerca de la creacin de AndroBasic.

Exit app:
Sale de la aplicacin.

Nuestro primer programa escrito en AndroBasic:

Vamos hacer un sencillo programa al que llamaremos 'Hola
Mundo'.
En el editor, dentro de la subrutina Sub Main/End Sub, escribiremos
Print "Hola Mundo el programa quedara as:

Sub Main
Print Hola Mundo
End Sub

Ahora vamos a ejecutarlo pulsando sobre el icono 'Run'.

Vemos que aparece en pantalla la frase 'Hola Mundo'.

Informacin detallada de las instrucciones/funciones del

lenguaje Basic que soporta AndroBasic ordenadas
alfabticamente:

ABS
Devuelve el valor absoluto.
Ejemplo:
x=-1
Print Abs(x)
Resultado:
1

ACOS
Devuelve el coseno de un ngulo expresado en radianes.
Ejemplo:
x=0.4
Print Acos(x)
Resultado:
1.15928

ACOSD
Devuelve el coseno de un ngulo expresado en grados.
Ejemplo:
x=0.4
 Print Acosd(x)
Resultado:
66.42182

ASC
Devuelve un nmero correspondiente al cdigo de carcter
ASCII (American StandarCode for Information Interchange).
Ejemplo:
x=@
Print Asc(x)
Resultado:
64

ASIN
Devuelve el seno de un ngulo expresado en radianes.
Ejemplo:
x=0.4
Print Asin(x)
Resultado:
0.41152

ASIND
Devuelve el seno de un ngulo expresado en grados.
Ejemplo:
x=0.4
Print Asind(x)
Resultado:
23.57818

ATAN
Devuelve el ngulo tangente expresado en radianes.
Ejemplo:
x=0.4
Print Atan(x)
Resultado:
0.38051

ATAND
Devuelve el ngulo tangente expresado en grados.
Ejemplo:
 x=0.4
Print Atand(x)
Resultado:
21.80141

BEEP
Genera un sonido de corta duracin.

BUTTONS OFF
Oculta de la pantalla los cinco botones.

BUTTONS ON
Se muestran en pantalla cinco botones pudiendo controlar que
botn ha sido pulsado gracias a la variable interna del
sistema but.
Estos son los valores que devuelve la variable but al pulsar uno
de los cinco botones:
Botn1=1, botn2=2, botn3=3, botn4=4 y botn5=5.
Para inicializar but, podemos usar el valor 0: but=0.

CALL
Llama a la subrutina con el nombre especificado.
Ejemplo:
Call nombresubrutina

CHR
Da un carcter correspondiente al valor del cdigo numrico
ASCII.
Ejemplo:
x=64
Print Chr(x)
Resultado:
@

CLS
Borra la pantalla.

COLORINK
Define el color del primer plano segn el cdigo de color [mirar
la tabla de Cdigos de color].
Ejemplo:
x=5
Colorink(x)
Print Hola
Resultado:
Hola [se visualiza el texto en color verde]

COLORPAPER
Define el color de fondo segn el cdigo de color [mirar la tabla
de Cdigos de color].
Ejemplo:
x=4
Colorpaper(x)
Resultado:
[se visualiza el fondo de pantalla en color rojo]

COS
Devuelve el coseno expresado en radianes.
Ejemplo:
x=0.4
Print Cos(x)
Resultado:
0.92106

COSD
Devuelve el coseno expresado en grados.
Ejemplo:
x=0.4
Print Cosd(x)
Resultado:
0.99998

DO
Inicia el bucle Do...Loop...

DO UNTIL
Inicia el bucle Do Until...Loop...y continua con el ciclo hasta que
se cumpla la condicin.

DO WHILE
Inicia el bucle Do While...Loop...y continua con el ciclo mientras
se cumpla la condicin.

ELSE
S la condicin precedida de If...Then no se cumple, se
procesan las instrucciones justo por debajo de Else hasta End
If.

ELSEIF...THEN
Hace la misma funcin que Else pero aadiendo condicin
exclusiva.

END IF
Acaba con el condicional If...Then/Else.

END SUB
Finaliza la subrutina Sub...End Sub.

EXIT DO
Sale del bucle Do...Loop...

EXIT FOR
Sale del bucle For...Next.

EXIT SUB
Sale de la subrutina Sub...End Sub.

FLOOR
Devuelve el ntegro.
Ejemplo:
x=1.4
Print Floor(x)
Resultado:
1

FOR...TO...STEP
Inicia un bucle For...Next hasta un nmero de veces.

IF...THEN
Condiciona dos elementos o ms y si se cumple, se procesan
las instrucciones justo por debajo de If...Then hasta Else/End If.

INPUTBOX
Recoge los datos introducidos por el usuario y los transfiere a
una variable.
Ejemplo:
Inputbox Introduzca un nombre;x
Print El nombre introducido es & x
Resultado:
Introduzca un nombre [David]
El nombre introducido es David

LEN
Devuelve la longitud de una cadena.
Ejemplo:
x=Barcelona
Print Len(x)
Resultado:
9

LINE
Dibuja una lnea de color [mirar la tabla de Cdigos de color]
hasta las coordenadas X e Y -final-.
Las coordenadas X e Y iniciales las aporta la
instruccin Point o en su caso, la ltima vez que se haya
llamado la instruccin Line.
Si no se llama por primera vez a la instruccin Point el valor
origen de las coordenadas X e Y valdrn 0.
Ejemplo:
Point(0,400,6) [X,Y,Color]
Line(1280,400,6) [X,Y,Color]
Resultado:
[Dibuja una lnea horizontal en el centro de la pantalla de
color azul]

LN
Da el logaritmo en base e.
Ejemplo:
x=1000
 Print Ln(x)
Resultado:
6.90775

LOG
Da el logaritmo en base 10.
Ejemplo:
x=1000
Print Log(x)
Resultado:
3

LOGARITHM
Da el logaritmo en cualquier base.
Ejemplo:
x=1000
b=10 [base]
Print Logarithm(x,b)
Resultado:
3

LOOP
Cierra el bucle Do...Loop y continua con el ciclo.

LOOP UNTIL
Cierra el bucle Do...Loop Until y continua con el ciclo hasta que
se cumpla la condicin.

LOOP WHILE
Cierra el bucle Do...Loop While y continua con el ciclo mientras
se cumpla la condicin.

MAX
Devuelve entre dos nmeros el ms grande.
Ejemplo:
Print Max(4,9)
Resultado:
9

MID
Selecciona caracteres desde una cadena entre la posicin
inicial hasta la longitud especificada.
Ejemplo:
x=Barcelona
Print Mid(x,4,3)
Resultado:
cel

MIN
Devuelve entre dos nmeros el ms pequeo.
Ejemplo:
Print Min(9,4)
Resultado:
4

MOD
Devuelve el resto despus de dividir un nmero entre un divisor.
Ejemplo:
Print Mod(3,2) [numero,divisor]
Resultado:
1

MSGBOX
Muestra en la pantalla superior el texto y espera a que se pulse
'Aceptar'.
Ejemplo:
Msgbox Piense un numero
Resultado:
Piense un numero

NEXT
Cierra el bucle For...Next y continua con el ciclo.

PAUSE
Detiene la ejecucin del programa durante un tiempo
expresado en milisegundos.
Ejemplo:
Pause(1000)
Resultado:
[Detiene el proceso en 1 seg.]
POINT
Dibuja un punto de color [mirar la tabla de Cdigos de color] en
las coordenadas X e Y.
Ejemplo:
Point(640,400,6) [X,Y,Color]
Resultado:
[Dibuja un punto en el centro de la pantalla de color azul]

POWER
Eleva a la potencia.
Ejemplo:
x=2
e=8
Print Power(x,e)
Resultado:
256 [el valor 2 se eleva a la potencia de 8]

PRINT
Imprime en pantalla un texto.
Ejemplo:
Print Hola Mundo
Resultado:
Hola Mundo

RANDOMIZE
Inicializa la semilla de la secuencia pseudoaleatria basado en
el reloj interno del sistema.

REM
No hay proceso alguno, simplemente podremos comentar las
diferentes lneas de nuestro programa.
Ejemplo:
Rem Proceso de encriptacin

RND
Genera un nmero pseudoaleatrio entre los rangos de min y
mx (inclusive).
Ejemplo:
min=1
 max=10
Print Rnd(min, max)
Resultado:
4

ROUND
Redondea un nmero.
Ejemplo:
x=1.5
Print Round(x)
Resultado:
2

SIN
Devuelve el seno expresado en radianes.
Ejemplo:
x=0.4
Print Sin(x)
Resultado:
0.38942

SIND
Devuelve el seno expresado en grados.
Ejemplo:
x=0.4
Print Sind(x)
Resultado:
0.00698

SQRT
Halla la raz cuadrada.
Ejemplo:
x=2
Print Sqrt(x)
Resultado:
1.414214

STOP
Detiene la ejecucin del programa.
SUB
Nombra a la subrutina Sub...End Sub.
Ejemplo:
Sub nombresubrutina

TAN
Devuelve la tangente expresado en radianes.
Ejemplo:
x=0.4
Print Tan(x)
Resultado:
0.42279

TAND
Devuelve la tangente expresado en grados.
Ejemplo:
x=0.4
Print Tand(x)
Resultado:
0.00698

Caractersticas especiales del lenguaje Basic

de AndroBasic:
No son admitidos los dos puntos ':' para separar
instrucciones/funciones en la misma lnea.
En un condicional, -despus de la instruccin Then y en la
misma lnea- no puede haber nada escrito.
Las variables no son sensibles si se escriben en
maysculas/minsculas y son convertidas internamente en
maysculas.
En los condicionales no son admitidos los parntesis.
Slo se admiten 30 parmetros por lnea como mximo.
Los programas no pueden contener ms de 2.000 lneas.
Las constantes como PI y E se escriben como CPI y CE
respectivamente.
Tanto las variables como la matriz son del tipo genricos, o
sea, pueden contener nmeros o cadenas. Ejem: a=5 o
a="hola".
Las variables/matriz no se declaran.
No es necesario inicializar las variables/matriz pero s
recomendable -sobre todo en clculos matemticos-.
Se pueden utilizar hasta un mximo de 100 variables.
Slo podemos utilizar una Matriz llamada matrix(a,b) siendo a
el ndice y b el subndice de la tabla. El valor mximo de
ndices para la matriz es de 10.000 por 10 de subndices.
Se pueden utilizar hasta un mximo de 100 subrutinas.
En cualquier momento de la ejecucin de un programa,
podemos abortarlo simplemente pulsando el icono 'Back' -en la
parte inferior izquierda de la pantalla-.

Operadores aritmticos:

+ [Adicin]
- [Sustraccin]
* [Multiplicacin]
/ [Divisin]
^ [Exponenciacin]
% [Mdulo aritmtico]

Operadores relacionales:

= [es igual que]

<> [no es igual que]
< [es menor que]
> [es mayor que]
<= [es menor o igual que]
>= [es mayor o igual que]

Operadores de cadena:
& [unin de cadenas]

Operadores lgicos:

And [dos elementos son verdaderos]

Or [al menos uno de los elementos es verdadero]
Xor [slo un elemento es verdadero]

Cdigos de color:

0 = negro
1 = gris oscuro
2 = gris medio
3 = gris claro
4 = rojo
5 = verde
6 = azul
7 = amarillo
8 = magenta
9 = can
10 = blanco

Listado de errores:

N1: 'If' without 'Else/ElseIf/End If'

N2: program without 'Sub Main'
N3: Too many parameters per line: (max.30)
N4: Syntax
N5: General process
N6: calculation parameters
N7: expected 'End Sub'
N8: 'For' without 'Next'
N9: 'Next' without 'For'
N10: 'Exit For' without 'Next'
N11: 'Call X' not found
N12: 'Exit Sub' without 'End Sub'
N13: 'Do Until' without 'Loop'
N14: 'Loop' without 'Do Until/Do While'
N15: 'Exit Do' without 'Loop'
N16: 'Do While' without 'Loop'
N17: 'Loop Until' without 'Do'
N18: 'Loop While' without 'Do'
N19: 'Else' without 'End If'
N20: Too many variables (max.100)
Publicado por Jordi Sorroche en 14:39