~~ODT~~

BASIC-256 Syntax Reference

Sintaxis del programa

Los programas de BASIC-256 consisten en una serie de instrucciones, separadas en lineas distintas, que se ejecutan en el orden en que aparecen.

2016/01/01 22:43

Constantes numéricas

Las constantes numéricas son cualesquiera caracteres numéricos, opcionalmente precedidos por un signo menos para indicar números negativos, y, en su caso, un punto decimal seguido por más caracteres numéricos que indican los valores decimales.

Los valores enteros positivos también pueden expresarse en sistema binario (base 2), octal (base 8) y hexadecimal (base 16). Basta con preceder los valores binarios con 0b (0b1110 = 14), los octales con 0o (0o177 = 27) y los hexadecimales con 0x (0xff= 255).

2016/01/01 22:43

Constantes de cadena

Las constantes de cadena consisten en cero o más caracteres encerrados entre comillas dobles (“).

2016/01/01 22:43

Variables

Los nombres de variables que contienen valores numéricos deben comenzar con una letra y pueden consistir en cualquier número de caracteres alfanuméricos. Se diferencia entre mayúsculas y minúsculas. Pueden ser usadas en sustitución de constantes numéricas.

Los nombres de las variables que contienen cadenas siguen las mismas reglas que las variables numéricas, pero deben terminar con un signo de dolar ($). Pueden ser usadas en sustitución de constantes de cadena.

A partir de la versión 1.99.99 no hace falta utilizar el símbolo $ para las variables que contengan cadenas

2016/01/01 22:43

Arrays

Los arrays ( a veces denominados vectores, matrices o “arreglos”) se crean usando el comando DIM o redimensionadas usando REDIM. Pueden contener datos numéricos o cadenas. El acceso a un elemento determinado del array se consigue indicando mediante corchetes la posición del elemento, empezando desde cero. También pueden crearse y acceder a arrays de dos dimensiones.
El tamaño de un array puede obtenerse usando [?][?,] y [,?] al final de la variable de array.

Ejemplo
print myarray[4]

mostrará en la pantalla el quinto elemento de “myarray”

2016/01/01 22:42

Arrays anónimos

Un array anónimo es un conjunto de valores numéricos o de valores de cadena, separados por comas, y encerrados entre llaves {}. Un array anónimo puede usarse bien en lugar de una variable de array, o bien para asignar valores a una variable de array.

Ejemplo
dim myarray(4)
myarray = {1, 2, 3, 4}
2016/01/01 22:42

Operadores

Los operadores +, -, *, / y ^ se usan para llevar a cabo sumas, restas, multiplicaciones, divisiones y exponentes de números enteros y de punto flotante. Son operandos válidos las constantes numéricas y/o las variables numéricas.

Los operadores %, \, &, | y ~ se usan para calcular el módulo, la división entera y las operaciones a nivel de bits “Y”, “O” y negación (“NO”) de expresiones enteras. Los números de punto flotante se convierten en enteros antes del cálculo.

El operador = se usa tanto para la asignación de variables como a modo de operador lógico de igualdad. El operador + puede ser usado para la concatenación de cualquier combinación de constantes de cadena y variables de cadena. El operador : permite separar varias instrucciones en una única linea. El operador ; suprime el salto de linea con que termina la ejecución de una instrucción PRINT. El operador # es una forma abreviada de la instrucción Rem, y puede usarse en su lugar.

Orden de operaciones
NivelOperadoresCategoría/Descripción
1( )Agrupación
2^Exponente
3- ~Menos unario y Negación a nivel de bits (“NO”)
4* / \Multiplicación and División
5% Resto entero (Mod)
6+ -Adicción, Concatenación, y Sustracción
7& |Operadores a nivel de bits “Y” y “O”
8< ⇐ > >= = <>Comparación (numérica y de cadenas)
9NOTNO unario
10ANDOperador lógico “Y”
11OROperador lógico “O”
12XOROperador lógico “O exclusivo”
2016/01/01 22:43

Statements and Functions - Alphabetic

Abs

Formato

abs ( expresión )

Descripción

Devuelve el valor absoluto de una expresión numérica.

Ejemplo
print abs(-45)
print abs(6.45)

mostrará: 

45
6.45
2016/01/01 22:42

Acos

Formato

acos ( expresión )

Descripción

Calcula el arco-coseno de expresión. Los ángulos deben expresarse en radianes (0 a 2pi).

Ver también

Asin, Atan, Cos, Degrees, Radians, Sin, Tan

2016/01/01 22:42

Asc

Formato

asc ( expresión )

Descripción

Convierte el primer carácter de la cadena expresión en un entero que representa su valor ASCII.

AscChrAscChrAscChrAscChrAscChrAscChr
32SPACE48064@80P96`112p
33!49165A81Q97a113q
34“50266B82R98b114r
35#51367C83S99c115s
36$52468D84T100d116t
37%53569E85U101e117u
38&54670F86V102f118v
39'55771G87W103g119w
40(56872H88X104h120x
41)57973I89Y105i121y
42*58:74J90Z106j122z
43+59;75K91[107k123{
44,60<76L92\108l124|
45-61=77M93]109m125}
46.62>78N94^110n126~
47/63?79O95_111o127
Ver también

Chr

Ejemplo
print asc("A")
print asc("blue")

mostrará: 

65
98
Disponible desde la versión

0.9.4

2016/01/01 22:42

Asin

Formato

asin ( expresión )

Descripción

Calcula el arco-seno de expresión. Los ángulos deben expresarse en radianes (0 a 2pi).

Ver también

Acos, Atan, Cos, Degrees, Radians, Sin, Tan

2016/01/01 22:42

Atan

Formato

atan ( expression )

Descripción

Calcula el arco-tangente de expresión. Los ángulos deben expresarse en radianes (0 a 2pi).

Ver también

Acos, Asin, Cos, Degrees, Radians, Sin, Tan

2016/01/01 22:42

Ceil

Format

ceil ( expresión )

Descripción

Devuelve el menor entero que sea mayor o igual a expresión.

Ver también

Floor

Ejemplo
print ceil(9.1)
print ceil(-5.4)

mostrará: 

10
-5
2016/01/01 22:42

Changedir

Formato

changedir expresión
changedir ( expresión )

Descripción

Cambia el directorio de trabajo actual a la ruta especificada en expresión. Para separar las carpetas en la descripción de la ruta completa se usa la barra (/), cualquiera que sea el sistema (incluido Windows).

Ver también

Close, Currentdir, Eof, Open, Read, Readline, Reset, Write, Writeline, Exists, Seek, Size

Disponible desde la versión

0.9.6r

2016/01/01 22:42

Chr

Formato

chr ( expresión )

Descripción

Convierte el número entero expresión en una cadena de un único carácter con el valor ASCII del número. Ver en asc una tabla completa de conversión de caracteres ASCII.

Ver también

Asc

Ejemplo
print chr(66)+chr(111)+chr(111)+chr(33)

mostrará: 

Boo!
Disponible desde la versión

0.9.4

2016/01/01 22:42

Circle

Formato

circle x,y,r

Descripción

Dibuja un círculo con centro en x,y y radio r, usando el color actual.

Ejemplo
color blue
rect 0,0,300,300
color red
circle 100,100,50

dibuja:
Circle

2016/01/01 22:42

Clickb

Formato

clickb
clickb ( )

Descripción

Devuelve los últimos botones del ratón que el usuario ha pulsado ( si está sobre el área de gráficos). Devuelve 0 si no se ha registrado ninguna pulsación. Si se han pulsado varios botones el valor es la suma de los valores de los botones pulsados.

Valores devueltos
ValorBotón del ratón pulsado
0Ninguno
1Izquierdo
2Derecho
4Central
Ver también

Clickclear, Clickx, Clicky, Mouseb, Mousex, Mousey

Ejemplo
# elimina cualquier pulsación previa
clickclear
# espera a que el usuario pulse el ratón
print "pulsa el ratón sobre el área de gráficos"
while clickb = 0
  pause .01
endwhile
# muestra el punto donde el usuario ha pulsado
print "El usuario ha pulsado en (" + clickx + "," + clicky + ")"
Disponible desde la versión

0.9.4d

2016/01/01 22:42

Clickclear

Formato

clickclear
clickclear ( )

Descripción

Deja ClickB, Clickx y Clicky con valor cero, de modo que se pueda conocer fácilmente cuando se registra la siguiente pulsación del ratón.

Ver también

Clickb, Clickx, Clicky, Mouseb, Mousex, Mousey

Ejemplo

Ver el programa de ejemplo en Clickb.

Disponible desde la versión

0.9.4d

2016/01/01 22:42

Clickx

Formato

clickx
clickx ( )

Descripción

Devuelve la coordenada x que el puntero del ratón tenía en el área de gráficos en el momento en que el usuario pulsó por última vez un botón del ratón.

Ver también

Clickclear, Clickb, Clicky, Mouseb, Mousex, Mousey

Ejemplo

Ver el programa de ejemplo en Clickb.

Disponible desde la versión

0.9.4d

2016/01/01 22:42

Clicky

Formato

clicky
clicky ( )

Descripción

Devuelve la coordenada y que el puntero del ratón tenía sobre el área de gráficos en el momento en que el usuario pulsó por última vez un botón del ratón.

Ver también

Clickclear, Clickb, Clickx, Mouseb, Mousex, Mousey

Ejemplo

Ver programa de ejemplo en Clickb.

Disponible desde la versión

0.9.4d

2016/01/01 22:42

Clg

Formato

clg

Descripción

Borra el contenido de la ventana de gráficos.

2016/01/01 22:42

Close

Formato

close
close ( )
close NúmerodeArchivo
close ( NúmerodeArchivo )

Descripción

Cierra un archivo abierto. Si no hay ninguno abierto con ese número de archivo, este comando no hace nada. Si el número de archivo no se especifica , se usa el número cero (0).

Ver también

Eof, Open, Read, Readline, Reset, Write, Writeline

2016/01/01 22:42

Cls

Formato

cls

Descripción

Borra el contenido de la ventana de texto.

2016/01/01 22:42

Color

Formato

color NombredelColor
color ( NombredelColor )
color valor_rgb
color ( valor_rgb )

Descripción

Establece como color de dibujo actual el NombredelColor, el color RGB - compuesto por la combinación rojo, azul, verde- , o el valor RGB.

Hay un color especial denominado CLEAR, cuyo valor es -1. Si se establece como color actual, los pixels o figuras que se dibujen borrarán los pixels del área de gráficos y los harán transparentes. Esto es especialmente útil cuando se crean sprites usando el comando Spriteslice.

Nombres de color y valores RGB
Nombre del colorValores RGB
black0, 0, 0<hi #000000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
white255, 255, 255<hi #FFFFFF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
red255, 0, 0<hi #FF0000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkred128, 0, 0<hi #800000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
green0, 255, 0<hi #00FF00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkgreen0, 128, 0<hi #008000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
blue0, 0, 255<hi #0000FF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkblue0, 0, 128<hi #000080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
cyan0, 255, 255<hi #00FFFF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkcyan0, 128, 128<hi #008080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
purple255, 0, 255<hi #FF00FF>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkpurple128, 0, 128<hi #800080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
yellow255, 255, 0<hi #FFFF00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkyellow128, 128 ,0<hi #808000>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
orange255, 102, 0<hi #FF6600>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkorange176, 61 ,0<hi #B03D00>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
grey164, 164 ,164<hi #A4A4A4>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
darkgrey128, 128 ,128<hi #808080>~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~~~SP~~</hi>
clear-1~~SP~~
Ver también

Rgb, GetColor

Ejemplo
clg
color grey
rect 0,0,graphwidth, graphheight
color red
circle 100,100,50
color rgb(255,160,160)
circle 100,100,25

dibujará un rectángulo gris con un círculo rojo con el centro rosa.
Color

Disponible desde la versión

0.9.5m

2016/01/01 22:42

Cos

Formato

cos ( expresión )

Descripción

Calcula el coseno de expresión. Expresión debe estar en radianes.

Nota

La función cos no produce un resultado exacto.

Ver también

Acos, Asin, Atan, Degrees, Radians, Sin, Tan

Ejemplo
clg
color black
# Traza una linea que cruza del area de gráficos
line 0,150,300,150
# punto inicial
lastx = 0
lasty = cos(0) * 50 + 150
# ahora, avanzamos a lo largo de la linea y trazamos
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = cos(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

mostrará:
Cosine Curve

2016/01/01 22:42

Currentdir

Formato

currentdir
currentdir ( )

Descripción

Devuelve el nombre de la ruta completa del directorio actual de BASIC-256. Para separar las carpetas en la descripción de la ruta completa se usa la barra (/), cualquiera que sea el sistema (incluido Windows).

Ver también

Changedir, Close, Eof, Open, Read, Readline, Reset, Write, Writeline, Exists, Seek, Size

Disponible desde la versión

0.9.6r

2016/01/01 22:42

Day

Formato

day
day ( )

Descripción

Devuelve el actual día del mes (1-31), de acuerdo con el reloj del sistema.

Ver también

Hour, Minute, Month, Msec, Second, Year

Ejemplo
print "La fecha de hoy es ";
print day + "/" (month + 1) + "/" + year

mostrará: 

La fecha de hoy es 30/11/2009
Disponible desde la versión

0.9.4

2016/01/01 22:42

DBClose

Formato

dbclose
dbclose ( )

Descripción

Cierra el archivo de base de datos SQLite actualmente abierto.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBCloseSet, DBExecute, DBFloat, DBInt, DBOpen, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBCloseSet

Formato

dbcloseset
dbcloseset ( )

Descripción

Cierra el recordset creado por DBOpenSet y que está actualmente abierto.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBExecute, DBFloat, DBInt, DBOpen, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBExecute

Formato

dbexecute InstrucciónSQL
dbexecute ( InstrucciónSQL )

Descripción

Ejecuta una instrucción SQL en el archivo de base de datos SQLite abierto. Esta instrucción no crea un recordset.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBFloat, DBInt, DBOpen, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBFloat

Formato

dbfloat ( NúmerodeColumna )

Descripción

Devuelve el valor de punto flotante (decimal) de la columna especificada de la fila actual en el recordset abierto.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBExecute, DBInt, DBOpen, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBInt

Formato

dbint ( NúmerodeColumna )

Descripción

Devuelve el valor entero de la columna especificada de la fila actual en el recordset abierto.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBExecute, DBFloat, DBOpen, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBOpen

Formato

dbopen ArchivoSQLite
dbopen ( ArchivoSQLite )

Descripción

Abre un archivo de base de datos SQLite. Si el archivo no existe, lo crea.

Ejemplo
#base de datos "foo" - crea una base de datos, introduce datos en una tabla, abre un recordset y lee datos desde la tabla.

# crea un nuevo archivo de base de datos o lo abre
dbopen "dbtest.sqlite3"

# borra la tabla existente en foo - Si es una base de datos nueva, el error se captura
onerror errortrap
dbexecute "drop table foo;"
offerror
# crea la tabla e introduce datos en ella
dbexecute "create table foo (id integer, words text, value decimal);"
dbexecute "insert into foo values (1,'one',3.14);"
dbexecute "insert into foo values (2,'two',6.28);"
dbexecute "insert into foo values (3,'three',9.43);"

# abre un recordset y recorre las filas de datos
dbopenset "select * from foo order by words;"
while dbrow()
	print dbint(0) + dbstring(1) + dbfloat(2)
end while
dbcloseset

# cierra todo
dbclose
end

errortrap:
# acepta el error - no muestra nada - vuelve a la instrucción siguiente
return

mostrará: 

1one3.14
3three9.43
2two6.28
Ver también

DBClose, DBCloseSet, DBExecute, DBFloat, DBInt, DBOpenSet, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBopenset

Formato

dbopenset InstrucciónSQL
dbopenset ( InstrucciónSQL )

Descripción

Ejecuta una instrucción SQL y crea un recordset que el programa puede utilizar.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBExecute, DBFloat, DBInt, DBOpen, DBRow, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBRow

Formato

dbrow
dbrow ( )

Descripción

Hace que se avance a la siguiente fila del recordset. Devuelve un valor verdadero (true) si hay una fila y falso (false) si se ha llegado al final del recordset.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBExecute, DBFloat, DBInt, DBOpen, DBOpenSet, DBString

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

DBString

Formato

dbstring ( NúmerodeColumna )

Descripción

Devuelve el valor de cadena de la columna especificada de la fila actual en el recordset abierto.

Ejemplo

Ver ejemplo de uso en la página de DBOpen.

Ver también

DBClose, DBCloseSet, DBExecute, DBFloat, DBInt, DBOpen, DBOpenSet, DBRow

Enlaces externos

Puede encontrarse más información acerca de bases de datos en general y SQLite en particular en SQLite Home Page y SQL at Wikipedia.

Disponible desde la versión

0.9.6y

2016/01/01 22:42

Degrees

Formato

degrees ( expresión )

Descripción

Convierte un ángulo en radianes a grados.

Ver también

Acos, Asin, Atan, Cos, Radians, Sin, Tan

2016/01/01 22:42

Dim

Formato

dim VariableNumérica ( NúmeroEntero )
dim VariableCadena$ ( NúmeroEntero )
dim VariableNumérica ( filas , columnas )
dim VariableCadena$ ( filas , columnas )

Descripción

Crea y devuelve un nuevo array de longitud NúmeroEntero o un array bidimensional organizado en filas y columnas. Dependiendo de la variable a que se asigne, se crea un array numérico o de cadenas.
El primer elemento de un array tiene como índice 0 (cero). El rango de los índices va desde 0 hasta longitud-1.

Ver también

Redim

Ejemplo
dim z(5)
z = {1, 2, 3, 4, 5}
print z[0] + " " + z[4]

dará como resultado: 

1 5
Ejemplo 2
dim c$(4)
c$ = {"cow", "brow", "how", "now"}
print c$[2] + " " + c$[3] + " ";
print c$[1] + " " + c$[0] + "?"

mostrará 

how now brown cow?
2016/01/01 22:42
 

End

Formato

end

Descripción

Finaliza la ejecución del programa.

Ejemplo
print "He terminado"
end
print "¿ O no ?"

mostrará: 

He terminado.
2016/01/01 22:43

Eof

Formato

eof
eof()
eof(NúmerodeArchivo)

Descripción

Devuelve un indicador binario (verdadero/falso) que señala si se ha llegado al final del archivo (EOF). Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Exists, Open, Read, Readline, Reset, Seek, Size, Write, Writeline

Disponible desde la versión

0.9.4

2016/01/01 22:43

Exists

Formato

exists ( expresión )

Descripción

Devuelve un indicador binario (verdadero/falso) que señala si existe o no la ruta de archivo especificada en expresión.

Ver también

Close, Eof, Open, Read, Readline, Reset, Seek, Size, Write, Writeline

Disponible desde la versión

0.9.4

2016/01/01 22:43

FastGraphics

Formato

fastgraphics

Descripción

Activa el modo “fastgraphics” hasta que el programa se detenga. El modo “fastgraphics” supone que la pantalla de gráficos no se actualiza hasta que se presente una instrucción REFRESH. Puede ser utilizado para acelerar significativamente animaciones complejas y eliminar parpadeos.

Nota

Cuando se hagan animaciones, se recomienda poner todas las instrucciones de dibujo en subrutinas y usar una única instrucción REFRESH después de que se haya dibujado completamente cada imagen o “frame”.

Ver también

Refresh

2016/01/01 22:43

Float

Formato

float ( expresión )

Descripción

Convierte expresión en un número de punto flotante (decimal). Float convertirá una cadena o un entero a un valor decimal. Si la expresión no puede ser convertida, se devuelve un valor cero.

Ver también

Int

Disponible desde la versión

0.9.4

2016/01/01 22:43

Floor

Formato

floor ( expression )

Descripción

Devuelve el mayor entero que sea menor o igual que expresión.

Ver también

Ceil

2016/01/01 22:43

Font

Formato

font NombredeFuente, puntos, peso

Descripción

Establece NombredeFuente como fuente a usar por la instrucción texto. El tamaño se define en puntos (1/72“). Peso representa un número de 1 a 100 que define el grosor de los caracteres: Fino=25, Normal=50 y Negrita=75.

Ejemplo
color grey
rect 0,0,graphwidth,graphheight
color red
font "Times New Roman",18,50
text 10,100,"This is Times New Roman"
color darkgreen
font "Tahoma",28,100
text 10,200,"This is BOLD!"

mostrará:

Ver también

Text

Disponible desde la versión

0.9.4

2016/01/01 22:43
 

GetColor

Formato

getcolor
getcolor()

Descripción

Devuelve el valor RGB del color de dibujo actual (el último que se haya establecido con la instrucción color). El valor RGB se calcula como ((rojo * 256) + verde *256) + azul, donde rojo, verde y azul toman valor entre 0 y 255. Si se estableció CLEAR como color de dibujo, se devuelve el valor -1.

Ver también

Color, Rgb

Ejemplo
color red
print getcolor

mostrará: 

16711680
Disponible desde la versión

0.9.5m

2016/01/01 22:43

GetSlice

Formato

getslice(x, y, anchura, altura)

Descripción

Devuelve una cadena que contiene una representación hexadecimal del rectángulo definido por los parámetros. El formato de la cadena es: 4 primeros bytes: anchura; 4 siguientes: altura; 6 bytes por cada pixel (anchura * altura).

Ver también

PutSlice

Disponible desde la versión

0.9.6b

2016/01/01 22:43

Goto

Formato

goto etiqueta

Descripción

Salta a la etiqueta especificada.

Ver también

Gosub / Return

Ejemplo
print "A mi";
goto salta
print " no";
salta:
print " me gustan las galletas."

will print 

A mi me gustan las galletas.
2016/01/01 22:43
 

Graphheight

Formato

graphheight
graphheight()

Descripción

Devuelve la altura (dimensión y) del área de gráficos actual.

Ver también

Graphsize, Graphwidth

Disponible desde la versión

0.9.3

2016/01/01 22:43

Graphsize

Formato

graphsize x_expresión, y_expresión

Descripción

Cambia el tamaño del área de gráficos y redibuja la aplicación BASIC256.

Ver también

Graphheight, Graphwidth

Disponible desde la versión

0.9.3

2016/01/01 22:43

Graphwidth

Formato

graphwidth
graphwidth()

Descripción

Devuelve la anchura (dimensión x) del área de gráficos actual.

Ver también

Graphheight, Graphsize

Disponible desde la versión

0.9.3

2016/01/01 22:43

Hour

Formato

hour
hour()

Descripción

Devuelve la hora actual del día (0-23) de acuerdo con el reloj del sistema.

Ejemplo
# mostrar la fecha
dim months$(12)
months$ = {"enero", "febrero", "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"}
print  right("0" + day, 2) + "-" + months$[month] + "-" +year
# mostrar la hora
h = hour
if h > 12 then
h = h - 12
ampm$ = "PM"
else
ampm$ = "AM"
end if
if h = 0 then h = 12
print  right("0" + h, 2) + "-" + right("0" + minute, 2) + "-" + right("0" + second, 2) + " " + ampm$

mostrará algo similar a:

15-julio-2010
10-00-02 PM
Ver también

Day, Hour, Minute, Month, Msec, Second, Year

Disponible desde la versión

0.9.4

2016/01/01 22:43

Instr

Formato

instr ( pajar , aguja )
instr ( pajar , aguja , inicio )
instr ( pajar , aguja , inicio , NoDistinguirMayúsculas)

Descripción

Comprueba si la cadena aguja está contenida en la cadena pajar. Si así ocurre, esta función devuelve la posición del carácter inicial del primer lugar donde aguja aparece. En otro caso, la función devuelve 0. Puede también especificarse opcionalmente una posición de partida para que la búsqueda comience en inicio y el valor booleano NoDistinguirMayúsculas para indicar que la búsqueda no diferencie entre mayúsculas y minúsculas.

Nota

La primera posición en la cadena es la 1.

Ejemplo
print instr("Hello", "lo")
print instr("101,222,333",",",5)

mostrará: 

4
8
Versión

0.9.6.55

2016/01/01 22:43

Int

Formato

int ( expresión )

Descripción

Convierte expresión en un número entero. Int convierte una cadena o un número de punto flotante en un valor entero. Si la expresión no puede convertirse, se devuelve un valor cero.

Ver también

Float

2016/01/01 22:43
 

Imgload

Formato

imgload x, y, NombredeArchivo
imgload x, y, escala, NombredeArchivo
imgload x, y, escala, rotación, NombredeArchivo

Descripción

Carga una imagen almacenada en un archivo y la muestra en el área de gráficos.
Los parámetros x e y representan la posición en la pantalla para el CENTRO de la imagen cargada. Este comportamiento es diferente al del resto de las instrucciones gráficas. El eje de rotación también es ese CENTRO.
La instrucción Imgload lee la mayoría de los formatos gráficos de archivo, incluyendo BMP (Windows Bitmap), GIF (Graphic Interchange Format),JPG/JPEG (Joint Photographic Experts Group) y PNG (Portable Network Graphics).
De manera opcional, el tamaño de la imagen cargada puede ser definida por escala (1=tamaño normal). También puede rotarse la imagen de acuerdo con un ángulo especificado ( en radianes, en sentido de las agujas del reloj) en torno al centro de la imagen.

Ver también

ImgSave

Disponible desde la versión

0.9.6l

2016/01/01 22:43

Input

Formato

input expresión, VariableCadena
input expresión, VariableNumérica
input VariableCadena
input VariableNumérica

Descripción

Espera a que el usuario teclee una linea de texto en el área de texto. Cuando el usuario pulsa la tecla intro o return, se lee la linea y se almacena en VariableCadena o VariableNumérica.
Opcionalmente, la función puede mostrar el texto expresión al usuario.
Si se ha especificado una variable numérica y se introducen datos no numéricos, se asignará el valor cero a la variable.
También pueden especificarse referencias a los elementos de un array.

2016/01/01 22:43

Key

Formato

key
key()

Descripción

Devuelve un valor entero que corresponde a la tecla que ha sido pulsada en el teclado. Si no se ha pulsado ninguna tecla desde la última llamada a la función key, esta devuelve el valor cero (0).

Nota
if key = 47 then print key

no mostrará los resultados deseados, debido a que se esta llamando a la función dos veces y ésta devolverá diferentes valores cada vez. Este código sí hace lo que se pretende: 

a = key
if a = 47 then print a
2016/01/01 22:43

LastError

Formato

lasterror
lasterror ( )

Descripción

Devuelve el número del último error en tiempo de ejecución.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterrorextra, Lasterrorline, Lasterrormessage, Offerror, Onerror

Disponible desde la versión

0.9.6z

2016/01/01 22:43

LastErrorExtra

Formato

lasterrorextra
lasterrorextra ( )

Description

Devuelve información “extra” del error, relativa a la instrucción que lo causa.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterror, Lasterrorline, Lasterrormessage, Offerror, Onerror

Disponible desde la version

0.9.6z

2016/01/01 22:43

LastErrorLine

Formato

lasterrorline
lasterrorline ( )

Descripción

Devuelve el número de linea del programa en la que ha ocurrido el error en tiempo de ejecución.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterror, Lasterrorextra, Lasterrormessage, Offerror, Onerror

Disponible desde la versión

0.9.6z

2016/01/01 22:43

LastErrorMessage

Formato

lasterrormessage
lasterrormessage ( )

Descripción

Devuelve una cadena que representa el último error en tiempo de ejecución.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterror, Lasterrorextra, Lasterrorline, Offerror, Onerror

Disponible desde la versión

0.9.6z

2016/01/01 22:43

Left

Formato

left( cadena, longitud)

Descripción

Devuelve una porción de cadena formada con los primeros longitud caracteres de la cadena.

Ver también

Mid, Right

Ejemplo
print left("Hello", 2)

will display 

He
Disponible desde la versión

0.9.5b

2016/01/01 22:43

Length

Formato

length( cadena )

Descripción

Devuelve el número de caracteres que hay en cadena.

2016/01/01 22:43

Line

Formato

line x0, y0, x1, y1
line(x0, y0, x1, y1)

Descripción

Traza una linea desde el punto x0,y0 hasta el punto x1,y1.

Ejemplo
color white
rect 0,0,300,300
color black
line 50,50,200,200
line 100,200,200,200
line 100,200,50,50

mostrará:
Line

2016/01/01 22:43

Log

Formato

log ( expresión )

Descripción

Devuelve el logaritmo en base e de expresión.

Ver también

Log10

Disponible desde la versión

0.9.5w

2016/01/01 22:43
 

Lower

Formato

lower( cadena)

Descripción

Devuelve cadena con todos los caracteres alfabéticos convertidos en minúsculas.

Ver también

Upper

Ejemplo
print lower("AZul!")

mostrará: 

azul!
Disponible desde la versión

0.9.5e

2016/01/01 22:43

Mid

Formato

mid( cadena, CarácterInicial, longitud)

Descripción

Devuelve una porción del la cadena especificada, empezando desde la posición CarácterInicial y continuando hasta alcanzar longitud caracteres o el final de la cadena (lo que ocurra antes).

Ver también

Left, Right

Ejemplo
print mid("Hello", 2, 3)
print mid("Hello", 2, 999)

mostrará: 

ell
ello
2016/01/01 22:43

Minute

Formato

minute
minute()

Descripción

Devuelve el minuto actual de la hora (0-59) de acuerdo con el reloj del sistema.

Ejemplo
# mostrar la fecha
dim months$(12)
months$ = {"enero", "febrero", "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"}
print  right("0" + day, 2) + "-" + months$[month] + "-" +year
# mostrar la hora
h = hour
if h > 12 then
h = h - 12
ampm$ = "PM"
else
ampm$ = "AM"
end if
if h = 0 then h = 12
print  right("0" + h, 2) + "-" + right("0" + minute, 2) + "-" + right("0" + second, 2) + " " + ampm$

mostrará algo similar a:

15-julio-2010
10-00-02 PM
Ver también

Day, Hour, Month, Msec, Second, Year

Disponible desde la versión

0.9.4

2016/01/01 22:43

Month

Formato

month
month()

Descripción

Devuelve el mes actual de acuerdo con el reloj del sistema. Enero es 0, febrero es 1,…diciembre es 11.

Ejemplo
cls
dim n$(12)
n$ = {"ene", "feb", "mar", "abr", "may", "jun", "jul", "ago", "sep", "oct", "nov", "dic"}
print day + "-" + n$[month] + "-" + year

el día de Año Nuevo mostraría: 

1-ene-2010
Ver también

Day, Hour, Minute, Msec, Second, Year

Disponible desde la versión

0.9.4

2016/01/01 22:43

Mouseb

Formato

mouseb
mouseb()

Descripción

Devuelve los botones del ratón que el usuario está pulsando ( si está sobre el área de gráficos). Devuelve 0 si no se registra ninguna pulsación. Si se pulsan varios botones, el valor es la suma de los valores de los botones pulsados.

Valores devueltos
ValorBotón del ratón pulsado
0Ninguno
1Izquierdo
2Derecho
4Central
Ver también

Clickb, Clickclear, Clickx, Clicky, Mousex, Mousey

Disponible desde la versión

0.9.4d

2016/01/01 22:43

Mousex

Formato

mousex
mousex()

Descripción

Devuelve la actual o última coordenada x del puntero del ratón en el área de gráficos.

Ver también

Clickb, Clickclear, Clickx, Clicky, Mouseb, Mousey

Disponible desde la versión

0.9.4d

2016/01/01 22:43

Mousey

Formato

mousey
mousey()

Descripción

Devuelve la actual o última coordenada y del puntero del ratón en el área de gráficos.

Ver también

Clickb, Clickclear, Clickx, Clicky, Mouseb, Mousex

Disponible desde la versión

0.9.4d

2016/01/01 22:43

NetClose

Formato

netclose
netclose ( )
netclose NúmerodeSocket
netclose ( NúmerodeSocket )

Descripción

Cierra la conexión de red (socket) especificada. Si NúmerodeSocket no se especifica, se utiliza el socket número cero (0).

Ejemplo

Ver ejemplo de uso en la página de NetConnect.

Ver también

NetAddress, NetConnect, NetData, NetListen, NetRead, NetWrite

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

NetConnect

Formato

netconnect NombredeServidor, NúmerodePuerto
netconnect ( NombredeServidor, NúmerodePuerto )
netconnect NúmerodeSocket, NombredeServidor, NúmerodePuerto
netconnect ( NúmerodeSocket, NombredeServidor, NúmerodePuerto )

Descripción

Abre una conexión de red (cliente) con un servidor. La dirección IP o el nombre del host del servidor se especifica en el argumento NombredeServidor, y el número de puerto de rede en el argumento NúmerodePuerto. Si no se indica un NúmerodeSocket se utilizara el número cero (0).

Ejemplo

Abra dos instancias de BASIC-256 en un mismo equipo. Pegue el código “servidor” en una y el código “cliente” en el otro. Ejecute en primer lugar el servidor y después el cliente. Puede verse como los mensajes son enviados de un lado a otro entre los dos procesos.

Código Servidor
# get a message and send back success
print "wait for connection on " + netaddress()
netlisten 9997
print "got connection"
do
   while not netdata
      pause .1
      print ".";
   end while
   n$ = netread
   print n$
   netwrite "I got '" + n$ + "'."
until n$ = "end"
netclose

mostrará (donde xxx.xxx.xxx.xxx es la dirección IPv4 de su equipo): 

wait for connection on xxx.xxx.xxx.xxx
got connection
.1 Hi There
....2 Hi There
........3 Hi There
..........4 Hi There
.....5 Hi There
.......6 Hi There
....7 Hi There
..........8 Hi There
....9 Hi There
.....10 Hi There
.end
Código cliente
# el usuario debe teclear un mensaje y enviarlo al servidor
input "enter message?", m$
netconnect "127.0.0.1", 9997
for t = 1 to 10
   pause rand
   netwrite t + " " + m$
   print netread
next t
netwrite "end"
print netread
netclose

mostrara: 

enter message?Hi There
I got '1 Hi There'.
I got '2 Hi There'.
I got '3 Hi There'.
I got '4 Hi There'.
I got '5 Hi There'.
I got '6 Hi There'.
I got '7 Hi There'.
I got '8 Hi There'.
I got '9 Hi There'.
I got '10 Hi There'.
I got 'end'.
Ver también

NetAddress, NetClose, NetData, NetListen, NetRead, NetWrite

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

NetData

Formato

netdata
netdata ( )
netdata NúmerodeSocket
netdata ( NúmerodeSocket )

Descripción

Devuelve el valor verdadero (true,1) si hay datos esperando a ser leídos usando la función [NetRead|NetRead]]. En otro caso devuelve el valor falso (false,0). Si no se especifica un NúmerodeSocket, se usará el número cero (0).

Ejemplo

Ver ejemplo de uso en la página de NetConnect.

Ver también

NetAddress, NetClose, NetConnect, NetListen, NetRead, NetWrite

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

NetListen

Format

netlisten NúmerodePuerto
netlisten ( NúmerodePuerto)
netlisten NúmerodeSocket, NúmerodePuerto
netlisten ( NúmerodeSocket, NúmerodePuerto)

Descripción

Abre una conexión de red (servidor) en un determinado puerto y espera a que otro programa se conecte. Si no se especifica NúmerodeSocket, se usará el número cero (0).

Ejemplo

Ver ejemplo de uso en la página de NetConnect.

Ver también

NetAddress, NetClose, NetConnect, NetData, NetRead, NetWrite

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

NetRead

Formato

netread
netread ( )
netread ( NúmerodeSocket )

Descripción

Lee datos de la conexión de red especificada y los devuelve como una cadena. Esta función esperará hasta que se reciban datos. Si no se especifica NúmerodeSocket, se utilizará el socket número cero (0).

Ejemplo

Ver ejemplo de uso en la página de NetConnect.

Ver también

NetAddress, NetClose, NetConnect, NetData, NetListen, NetWrite

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

NetWrite

Format

netwrite cadena
netwrite ( cadena )
netwrite NúmerodeSocket, cadena
netwrite ( NúmerodeSocket, cadena )

Descripción

Envía una cadena a la conexión de red abierta que se especifique. Si no se especifica NúmerodeSocket, se utilizará el socket número cero (0).

Ejemplo

Ver ejemplo de uso en la página de NetConnect.

Ver también

NetAddress, NetClose, NetConnect, NetData, NetListen, NetRead

Disponible desde la versión

0.9.6.31

2016/01/01 22:43

Open

Formato

open NombredeArchivo
open(NombredeArchivo)
open NúmerodeArchivo, NombredeArchivo
open(NúmerodeArchivo, NombredeArchivo)

Descripción

Abre un archivo para lectura y escritura. El nombre del archivo es especificado mediante una cadena, y puede ser una ruta absoluta o relativa. Si el número de archivo no se especifica , se usa el número cero (0).

Nota

BASIC-256 puede tener hasta 8 archivos abiertos a la vez. Los archivos se numeran desde el 0 hasta el 7. Abrir un archivo con un número cuando ya hay otro abierto con ese número, cerrará este último.

Ver también

Changedir, Close, Currentdir, Eof, Kill, Read, Readline, Reset, Write, Writeline, Exists, Seek, Size

2016/01/01 22:43

OffError

Formato

offerror

Descripción

Desactiva la captura de errores y restaura el comportamiento por defecto en caso de error.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterror, Lasterrorextra, Lasterrorline, Lasterrormessage, Onerror

Disponible desde la versión

0.9.6z

2016/01/01 22:43

OnError

Formato

onerror etiqueta

Descripción

Hace que la subrutina indicada por etiqueta sea ejecutada cuando un error en tiempo de ejecución ocurra. El control del programa puede ser devuelto a la siguiente instrucción con una instrucción Return en la subrutina.

Ejemplo

Ver ejemplo de uso en la página Códigos de error.

Ver también

Error Codes, Lasterror, Lasterrorextra, Lasterrorline, Lasterrormessage, Offerror

Disponible desde la versión

0.9.6z

2016/01/01 22:43

Pause

Formato

pause segundos
pause (segundos)

Descripción

Detiene la ejecución durante el número de segundos especificado. El valor de segundos puede ser un valor decimal, por lo que es posible conseguir una precisión inferior al segundo.

2016/01/01 22:43

Pixel

Formato

pixel (x, y )

Descripción

Devuelve el valor RGB del pixel situado en las coordenadas x,y. Si el pixel no ha sido modificado desde la última instrucción Clg o fue pintado con el color CLEAR, se devuelve el valor -1.

Ver también

Rgb

Disponible desde la versión

0.9.5m

2016/01/01 22:43

Plot

Formato

plot x, y
plot ( x, y )

Descripción

Cambia el pixel situado en las coordenadas x, y del área de gráficos al color actual.

2016/01/01 22:43

Poly

Formato

poly variable de array numérica
poly {x1, y1, x2, y2, x3, y3 …}

Descripción

Dibuja un polígono. Los lados del polígono son definidos por los valores almacenados en el array, el cual debe contener pares x,y secuencialmente. La (longitud del array/2) dará el número de puntos. Un polígono puede tambien especificarse usando una lista de pares x,y encerrada entre llaves {}.

Nota

El número de puntos, como argumento del array, fue eliminado de la instrucción poly en la versión 0.9.4

Ver también

Stamp

Ejemplo
color blue
rect 0,0,300,300
color green
dim tri(6)
tri = {100, 100, 200, 200, 100, 200}
poly tri
color blue
rect 0,0,300,300
color green
poly {100, 100, 200, 200, 100, 200}

Ambos programas usan la instrucción poly para dibujar lo siguiente:

2016/01/01 22:43

Print

Formato

print expresión [ ; ]

Descripción

Escribe un texto en el area de texto, añadiendo un salto de linea. Si se incluye el punto y coma opcional, no se incluye el salto de linea.

Ver también

Decimal

2016/01/01 22:43

PutSlice

Formato

putslice x, y, recorte$
putslice x, y, recorte$, ColorTransparente

Descripción

Pone en la pantalla el gráfico almacenado en la cadena recorte$, situándolo en las coordenadas x,y. Si se especifica un color transparente, los puntos de ese color no se dibujan.

Ver también

GetSlice

Disponible desde la versión

0.9.6b

2016/01/01 22:43

Radianes

Formato

radians ( expresión )

Descripción

Convierte un ángulo en grados a radianes.

Ver también

Acos, Asin, Atan, Cos, Degrees, Sin, Tan

2016/01/01 22:43

Rand

Formato

rand
rand()

Descripción

Devuelve un número aleatorio entre 0 y 1. La distribución de los valores es uniforme.

Nota

Para obtener números aleatorios entre otro intervalo de valores, basta con multiplicar o sumar los números apropiados. Por ejemplo, para generar un entero entre 0 y 10, puede usarse la expresión int(rand * 10).

2016/01/01 22:43

Read

Formato

read
read()
read(NúmerodeArchivo)

Descripción

Lee y devuelve un token de un archivo abierto. Un token es cualquier cadena de caracteres separada por un espacio, tabulación o carácter de nueva linea. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Readline, Reset, Write, Writeline, Exists, Seek, Size

2016/01/01 22:43

Readline

Formato

readline
readline()
readline(NúmerodeArchivo)

Descripción

Lee y devuelve una linea completa de un archivo abierto. Si el número de archivo no se especifica, se usa el número cero.

Ver también

Close, Eof, Open, Read, Reset, Write, Writeline, Exists, Seek, Size

2016/01/01 22:43

Rect

Formato

rect x,y,anchura,altura
rect ( x, y, anchura, altura )

Descripción

Dibuja un rectángulo de (anchura x altura) pixels, usando el color actual. La esquina superior izquierda estará situada en x, y.

Ejemplo
color white
rect 0,0,300,300
color red
rect 50,50,150,150
color blue
rect 100,100,150,150
color green
rect 10,140,280,20

mostrará:

2016/01/01 22:43

Redim

Formato

redim VariableNumérica( NúmeroEntero )
redim VariableCadena$( NúmeroEntero )
redim VariableNumérica( filas , columnas )
redim VariableCadena$( filas , columnas )

Descripción

Redimensiona un array previamente creado, conservando los datos. Si se aumenta el tamaño del array, los nuevos elementos serán inicializados con cero o una cadena vacía. Si se reduce el tamaño, los elementos de la parte final se suprimen y se pierden.

Ver también

Dim

Disponible desde la versión

0.9.5t

2016/01/01 22:43

Refresh

Formato

refresh

Descripción

Actualiza la ventana de gráficos para mostrar lo que se ha dibujado desde el último comando refresh. Refresh sólo funciona en el modo Fastgraphics.

Ver también

Fastgraphics

2016/01/01 22:43

Rem

Formato

rem comentario
# comentario

Descripción

Linea de comentario. Una linea que comienza con REM ( o la abreviatura #) se ignora.

2016/01/01 22:43

Reset

Formato

reset
reset()
reset(NúmerodeArchivo)

Descripción

Borra el contenido de un archivo abierto. Todos los datos almacenados en él se pierden. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Read, Readline, Write, Writeline, Exists, Seek, Size

2016/01/01 22:43

Rgb

Formato

rgb( rojo, verde, azul )

Descripción

Devuelve el valor RGB del color definido por sus componentes rojo, verde y azul. Los valores válidos para rojo, verde y azul van del 0 al 255.

Ver también

Color, GetColor, Pixel

Disponible desde la versión

0.9.5m

2016/01/01 22:43
Formato

right( cadena, longitud)

Descripción

Devuelve una porción de cadena formada con los últimos longitud caracteres de la cadena.

Ver también

Mid, Left

Ejemplo
print right("Hello", 2)

mostrará: 

lo
Disponible desde la versión

0.9.5b

2016/01/01 22:43

Say

Formato

say expresión
say ( expresión )

Descripción

Usa el motor del sistema “Text to Speech” (TTS) para decir la expresión. En LINUX son necesarias las bibliotecas FLite o eSpeak. En Windows se usará la voz SAPI predeterminada.

Notas

En Windows, SAPI usará la voz predeterminada que se haya definido en el panel de control. En Linux/Mac, si se usa la biblioteca eSpeak es necesario copiar el archivo de voz elegido con el nombre default. 

# Instrucciones para establecer como lenguaje predeterminado "es" en Ubuntu 10.10
# (en tu sistema podría ser diferente)
cd /usr/share/espeak-data/voices
sudo cp es default
Disponible desde la versión

0.9.4

2016/01/01 22:43

Second

Formato

second
second()

Descripción

Devuelve el segundo actual (0-59) dentro del minuto actual, de acuerdo con el reloj del sistema.

Ejemplo
# mostrar la fecha
dim months$(12)
months$ = {"enero", "febrero", "marzo", "abril", "mayo", "junio", "julio", "agosto", "septiembre", "octubre", "noviembre", "diciembre"}
print  right("0" + day, 2) + "-" + months$[month] + "-" +year
# mostrar la hora
h = hour
if h > 12 then
h = h - 12
ampm$ = "PM"
else
ampm$ = "AM"
end if
if h = 0 then h = 12
print  right("0" + h, 2) + "-" + right("0" + minute, 2) + "-" + right("0" + second, 2) + " " + ampm$

mostrará algo similar a:

15-julio-2010
10-00-02 PM
Ver también

Day, Hour, Minute, Month, Msec, Year

Disponible desde la versión

0.9.4

2016/01/01 22:43

Seek

Formato

seek posición
seek ( posición )
seek NúmerodeArchivo, posición
seek ( NúmerodeArchivo, posición )

Descripción

Mueve el punto de lectura/escritura a una posición determinada (desplazamiento en bytes desde el inicio del archivo) dentro del un archivo abierto. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Read, Readline, Reset, Write, Writeline, Exists, Size

Disponible desde la versión

0.9.4

2016/01/01 22:43

Sin

Formato

sin ( expresión )

Descripción

Calcula el seno de expresión. Expresión debe estar en radianes.

Nota

La función sin no produce un resultado exacto.

Ver también

Acos, Asin, Atan, Cos, Degrees, Radians, Tan

Ejemplo
clg
color black
# Traza una linea que cruza el area de gráficos
line 0,150,300,150
# punto inicial
lastx = 0
lasty = sin(0) * 50 + 150
# ahora, avanzamos a lo largo de la linea y trazamos
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = sin(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

mostrará: Sine Curve

2016/01/01 22:43

Size

Formato

size
size()
size(NúmerodeArchivo)

Descripción

Devuelve el tamaño en bytes de un archivo abierto. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Read, Readline, Reset, Write, Writeline, Exists, Seek

Disponible desde la versión

0.9.4

2016/01/01 22:43

Sound

Formato

sound frecuencia, duración
sound ( frecuencia, duración )
sound ( array )
sound array
sound {frecuencia1, duración1, frecuencia2, duración2, …}

Descripción

Produce un sonido mediante los altavoces del equipo. La frecuencia se expresa en Hz y la duración en milisegundos (1/1000 de un segundo). La instrucción puede recibir también un array o lista que contenga las frecuencias y duraciones. Esto elimina cualquier chasquido entre sonidos cuando se hace sonar sucesivamente más de uno. El soporte para sonido en sistemas LINUX se incorporó en la versión 0.0.5g. La instrucción fue modificada para usar el dispositivo de sonido predeterminado en Windows en la versión 0.9.5h.

Ver también

Volume

2016/01/01 22:43

Spritecollide

Formato

spritecollide ( sprite1, sprite2)

Descripción

Devuelve verdadero si los dos sprites están chocando. La función Spritecollide assume que los sprites están definidos por un rectángulo del tamaño de la imagen cargada. La colisión se calcula usando esos rectángulos. Para sprites redondos o de formas extrañas esta función puede detectar falsas colisiones.

Ver también

Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spritedim

Formato

spritedim n
spritedim ( n )

Descripción

Crea n áreas de almacenamiento de sprites en la memoria . En el programa se accede a los sprites por un número de sprite de 0 a n-1.

Ver también

Spritecollide, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spriteh

Formato

spriteh ( NúmeroSprite )

Descripción

Devuelve la altura, en pixels, de un sprite que se ha cargado.

Ver también

Spritecollide, Spritedim, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spritehide

Formato

spritehide NúmeroSprite
spritehide ( NúmeroSprite )

Descripción

Oculta un sprite. Toda la información sobre la imagen y su posición se mantiene.

Ver también

Spritecollide, Spritedim, Spriteh, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spriteload

Formato

spriteload NúmeroSprite, NombreArchivo
spriteload ( NúmeroSprite, NombreArchivo )

Descripción

Carga una imagen o gráfico desde un archivo y lo guarda como un sprite. El sprite estará activo y podrá ser movido pero no se mostrará en pantalla hasta que la instrucción Spriteshow se ejecute para ese sprite. La instrucción Spriteload lee la mayoría de los formatos de imagen habituales, incluyendo: BMP (Windows Bitmap), GIF (Graphic Interchange Format),JPG/JPEG (Joint Photographic Experts Group), y PNG (Portable Network Graphics).

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spritemove

Formato

spritemove NúmeroSprite, dx, dy
spritemove ( NúmeroSprite, dx, dy )

Descripción

Mueve un sprite, partiendo se su posición actual,el número de pixels especificados. El movimiento se limitará a la pantalla actual.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spriteplace

Formato

spriteplace NúmeroSprite, x, y
spriteplace ( NúmeroSprite, x, y )

Descripción

Sitúa el centro de un sprite en una posición específica de la pantalla. Al igual que en Imgload, la posición del sprite se refiere al punto central del sprite y no a la esquina superior izquierda, como ocurre con la mayoría de las instrucciones gráficas.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteshow, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spriteshow

Formato

spriteshow NúmeroSprite
spriteshow ( NúmeroSprite )

Descripción

Muestra un sprite que está oculto.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteslice, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spriteslice

Formato

spriteslice NúmeroSprite, x, y, anchura, altura
spriteslice ( NúmeroSprite, x, y, anchura, altura )

Descripción

Copia la región rectangular de la pantalla que tiene la esquina superior izquierda en las coordenadas x,y y la anchura y altura especificadas, y crea un sprite. El sprite estará activo y podrá ser movido pero no se mostrará en pantalla hasta que la instrucción Spriteshow se ejecute. Se recomienda usar la instrucción Clg antes de dibujar y recortar el sprite. Todos los pixels no coloreados serán transparentes cuando el sprite se dibuje en la pantalla. Los pixels transparentes también se pueden conseguir dibujando con el color CLEAR.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spritemove, Spriteplace, Spriteshow, Spritev, Spritew, Spritex, Spritey

Disponible desde la versión

0.9.6o

2016/01/01 22:43

Spritev

Formato

spritev ( NúmeroSprite )

Descripción

Devuelve verdadero si el sprite es visible.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritex, Spritey

Disponible desde la versión

0.9.6o

2016/01/01 22:43

Spritew

Formato

spritew ( NúmeroSprite )

Descripción

Devuelve la anchura, en pixels, de un sprite que se ha cargado.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritex, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spritex

Formato

spritex ( NúmeroSprite )

Descripción

Devuelve la coordenada x del punto central de un sprite que se ha cargado.

Ver también

Spritecollide, Spritedim, Spriteh, Spritehide, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritey

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Spritey

Formato

spritey ( NúmeroSprite )

Descripción

Devuelve la coordenada y del punto central de un sprite que se ha cargado.

Ver también

Spritecollide, Spritedim, Spriteh, Spriteload, Spritemove, Spriteplace, Spriteshow, Spriteslice, Spritev, Spritew, Spritex

Disponible desde la versión

0.9.6n

2016/01/01 22:43

Stamp

Formato

stamp x, y, array
stamp x, y, {x1, y1, x2, y2, x3, y3 …}
stamp x, y, escala, array
stamp x, y, escala, {x1, y1, x2, y2, x3, y3 …}
stamp x, y, escala, rotación, array
stamp x, y, escala, rotación, {x1, y1, x2, y2, x3, y3 …}

Descripción

Dibuja un polígono con la esquina superior izquierda (origen) en x,y. De manera opcional, el tamaño del polígono puede ser definido por escala (1=tamaño normal). También se puede rotar la imagen de acuerdo con un ángulo especificado ( en radianes, en sentido de las agujas del reloj) en torno al origen. Los lados del polígono son definidos por los valores almacenados en el array, el cual debe contener pares x,y secuencialmente. La (longitud del array/2) dará el número de puntos. El polígono puede también especificarse usando una lista de pares x,y encerrada entre llaves {}.

Ver también

Poly

Ejemplo

Los dos bloques de código que aparecen a continuación dibujan un par de triángulos verdes en el área de gráficos: 

clg
color blue
rect 0,0,300,300
color green
dim tri(6)
tri = {0, 0, 100, 100, 0, 100}
# dibuja el triángulo en 0,0 (tamaño normal)
stamp 100, 100, tri
# dibuja el triángulo en 200,100 (mitad del tamaño)
stamp 200, 100, .5, tri
clg
color blue
rect 0,0,300,300
color green
# dibuja el triángulo en 0,0 (tamaño normal)
stamp 100, 100, {0, 0, 100, 100, 0, 100}
# dibuja el triángulo en 200,100 (mitad del tamaño)
stamp 200, 100, .5, {0, 0, 100, 100, 0, 100}

Ambos programas mostrarán:

Disponible desde la versión

0.9.4

2016/01/01 22:43

String

Formato

string ( expresión )

Descripción

Devuelve la representación en forma de cadena de un número.

Ver también

Decimal

2016/01/01 22:43

System

Formato

system expresión
system ( expresión )

Descripción

Ejecuta un comando del sistema en una ventana de terminal. PRECAUCIÓN: Esta instrucción puede ser muy peligrosa. Sólo debe usarse si se sabe lo que se está haciendo.

Esta instrucción puede ser desactivada en prevención de posibles problemas de seguridad del sistema. La configuración se puede hacer en el IDE, accediendo al menú Edición>Preferencias.

Disponible desde la versión

0.9.5h

2016/01/01 22:43

Tan

Formato

tan ( expresión )

Descripción

Calcula la tangente de expresión. Expresión debe estar en radianes.

Nota

La función tan no produce un resultado exacto.

Ver también

Acos, Asin, Atan, Sin, Cos, Degrees, Radians

Ejemplo
clg
color black
# Traza una linea que cruza el area de gráficos
line 0,150,300,150
# punto inicial
lastx = 0
lasty = tan(0) * 50 + 150
# ahora, avanzamos a lo largo de la linea
for x = 0 to 300 step 5
   angle = x / 300 * 2 * pi
   y = tan(angle) * 50 + 150
   line lastx, lasty, x, y
   lastx = x
   lasty = y
next x

mostrara: tan.jpg

2016/01/01 22:43

Text

Formato

text x, y, cadena
text ( x, y, cadena )

Descripción

Muestra una cadena de texto en el área de gráficos, a partir de la coordenada x,y y utilizando el color y la fuente actuales.

Ejemplo
color grey
rect 0,0,graphwidth,graphheight
color red
font "Times New Roman",18,50
text 10,100,"This is Times New Roman"
color darkgreen
font "Tahoma",28,100
text 10,200,"This is BOLD!"

mostrara:

Ver también

Color, Font

Disponible desde la versión

0.9.4

2016/01/01 22:43

Upper

Formato

upper ( cadena )

Descripción

Devuelve cadena con todos los caracteres alfabéticos convertidos en mayúsculas.

Ver también

Lower

Ejemplo
print upper("AZul!")

mostrará 

AZUL!
Disponible desde la versión

0.9.5e

2016/01/01 22:43

Volume

Formato

volume nivel
volume ( nivel )

Descripción

Ajusta el volumen de las notas que suenan con la instrucción Sound. El nivel del volumen debe ser un valor numérico entre 0 y 10. El nivel por defecto es 5.

Ver también

Sound

Disponible desde la versión

0.9.5i

2016/01/01 22:43

WAVplay

Formato

wavplay NombredeArchivo
wavplay ( NombredeArchivo )

Descripción

Reproduce un archivo de audio WAV asíncronamente (en segundo plano).

Ver también

WAVstop WAVwait

Disponible desde la versión

0.9.4

2016/01/01 22:44

WAVstop

Formato

wavstop

Descripción

Detiene la reproducción del archivo de audio WAV que se está ejecutando en segundo plano.

Ver también

WAVplay WAVwait

Disponible desde la versión

0.9.4

2016/01/01 22:44
 

Write

Formato

write cadena
write ( cadena )
write NúmerodeArchivo, cadena
write ( NúmerodeArchivo, cadena )

Descripción

Escribe cadena al final de un archivo abierto. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Read, Readline, Reset, Writeline, Exists, Seek, Size

2016/01/01 22:44

Writeline

Formato

writeline cadena
writeline ( cadena )
writeline NúmerodeArchivo, cadena
writeline ( NúmerodeArchivo, cadena )

Descripción

Escribe cadena con un caracter de salto de linea al final de un archivo abierto. Si el número de archivo no se especifica, se usa el número cero (0).

Ver también

Close, Eof, Open, Read, Readline, Reset, Write, Exists, Seek, Size

Disponible desde la versión

0.9.4

2016/01/01 22:44

Year

Formato

year
year ( )

Descripción

Devuelve el año actual (con cuatro dígitos), de acuerdo con el reloj del sistema.

Ejemplo
print "La fecha de hoy es ";
print day + "/" (month + 1) + "/" + year

mostrará: 

La fecha de hoy es 30/11/2009
Ver también

Day, Hour, Minute, Month, Msec, Second

Disponible desde la versión

0.9.4

2016/01/01 22:44