TEIMSI

Plataforma del desarrollador de textos programados

Indice de contenido -> Capítulo 9 - Funciones para Matrices

A continuación se describe el uso de las siguientes funciones predeterminadas en TEIMSI:

1)- array(lista)

2)- array_fill(cantidad,variable)

3)- count(matriz)

4)- explode(separador,cadena)

5)- getitem(matriz,entero)

6)- implode(separador,matriz)

7)- setitem(matriz,entero,variable)

array(lista)

La función "array(lista)", devuelve una matriz compuesta por los ítems separados por "," coma que se le pasan como parámetros. Si se le pasa un único entero no negativo, este indica el tamaño (cantidad de ítems) de la matriz, cada ítem tomará el valor del número entero -1. Los ítems en la lista pueden ser variables dinámicas o estáticas con cadenas, números (enteros o de precisión doble) y booleanos. Se exceptúan las matrices como ítems de matrices para esta versión. Para saber el tamaño de la matriz se utiliza la función "count".

Expresar "var matriz=array()" es idéntico a expresar "var matriz=array(0)", crea una matriz vacía pero que se puede agrandar asignando algún elemento cuyo índice es mayor o igual al tamaño de la matriz; ver el ejemplo mostrado abajo.

Sintaxis

array(lista)

Parámetros

lista/entero

Lista de variables dinámicas o estáticas separadas por ",". Por ejemplo var matriz=array("Pino",true,2, "Eucalipto",true,3, "Roble",true,1). Puede pasarse un entero que indica el tamaño de la matriz, la cual se llenará de ítems con números enteros -1.

Valor devuelto

matriz

Variable tipo matriz de TEIMSI.

Ejemplo:



	// El siguiente programa de ejemplo muestra como crear una matriz, asignar ítems, mostrar su tamaño y su contenido en un texto cuyas líneas son los ítems de la misma.  Se utiliza la función "implode" que recibe dos parámetros el primero el separador (en este caso es _nl que equivale a chr(13)+chr(10)) y el segundo la matriz, "implode" crea una cadena concatenando los ítems de la matriz separados por el separador.

	var matriz=array()

		// Asignar cadenas a los ítems del 2 al 7. Los ítems 0 y 1 quedarán con el valor predeterminado (-1).

	for(var k=2;k<8;k++){
		matriz[k]="	La raíz cuadrada de "+k+ " es igual a " + sqrt(k)
	}
		// Agrandar la matriz a tamaño 10,  el ítem 8 quedará con el valor predeterminado (-1).

	matriz[9]="<ítem final>"

	alert("La matriz tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

	var matriz=array("Hola","Mundo")

	alert("La matriz ahora tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

Ver también <<array_fill>>, <<implode>>

Volver arriba

array_fill

La función "array_fill", devuelve una matriz compuesta por ítems repetidos una cierta cantidad de veces (primer parámetro) a partir ítem original (segundo parámetro). Eso significa que el primer parámetro es el tamaño que tendrá la matriz y es un entero.

Sintaxis

array_fill(cantidad,variable)

Parámetros

cantidad	Un entero que indica la cantidad de ítems repetidos (eso es el tamaño de la matriz).
variable	Variable utilizada para copiar en la matriz cada ítem.

Valor devuelto

matriz

Variable tipo matriz de TEIMSI.

Ejemplo:



	// El siguiente programa de ejemplo muestra como usar array_fill.

	var matriz=array_fill(7,"Hola")
	alert("La matriz tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

Ver también <<array(lista)>>, <<implode>>

Volver arriba

count

La función "count", devuelve un entero que indica el tamaño de una matriz (eso es la cantidad de ítems que tiene).

Sintaxis

count(matriz)

Parámetros

matriz

Variable tipo matriz de TEIMSI.

Valor devuelto

Entero

Variable tipo número entero de TEIMSI.

Ejemplo:



	var matriz=array(5,4,2,3)
	alert("La matriz tiene " + count(matriz) + " ítems")

Ver también <<array(lista)>>

Volver arriba

explode

La función "explode", crea una matriz de cadenas a partir de una cadena (segundo parámetro) que tiene los ítems de matriz separados por una cadena separadora (primer parámetro).

Sintaxis

explode(separador,cadena)

Parámetros

separador	Variable tipo cadena de TEIMSI.
cadena	Variable tipo cadena de TEIMSI.

Valor devuelto

matriz

Variable tipo matriz de TEIMSI.

Ejemplo:



	var matriz=explode(",", "Hola,Mundo,!")
	alert("La matriz tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

Ver también <<implode>>, <<array(lista)>>

Volver arriba

getitem

La instrucción "getitem", devuelve un ítem de una matriz. Se expresa con "matriz[entero]", donde "matriz" es el primer parámetro y entero es el segundo.

Ejemplo:



	var matriz=explode(",", "Hola,Mundo,!")

	alert(matriz[1])

	alert(getitem(myarray,1))		//	Realiza la misma tarea.

Ver también <<setitem>>

Volver arriba

implode

La función "implode", devuelve una cadena que resulta de unir las cadenas de una matriz (segundo parámetro) mediante separadores iguales (cadena del primer parámetro).

Sintaxis

implode(separador,matriz)

Parámetros

separador	Variable tipo cadena de TEIMSI.
matriz	Variable tipo matriz de TEIMSI.

Valor devuelto

cadena

Variable tipo cadena de TEIMSI.

Ejemplo:



	var matriz=array("Hay ",4," puntos cardinales.")

	alert("Contenido de la matriz:"  + implode("", matriz))

Ver también <<array(lista)>>, <<explode>>

Volver arriba

setitem

La instrucción "setitem", establece un ítem de una matriz. Se expresa con "matriz[entero]=variable".

Ejemplo:



	//	El siguiente programa muestra como establecer un ítem en una matriz.

	var matriz=explode(",", "Hola,Mundo,!")

	alert("La matriz tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

	matriz[1]="Comrade"		//	Igual que: setitem(myarray,1,"Comrade")
	matriz[3]="."

	alert("La matriz ahora tiene tamaño "+count(matriz)+_nl+"La matriz tiene lo siguiente:"+_nl+implode(_nl,matriz))

Ver también <<getitem>>

Volver arriba