Manejo de matrices

$Filtrar

$Filtrar(M: <code>matriz, Condicion: texto): matriz</code>

• Descripción

  Devuelve una matriz que introducimos como parámetro de la función, pero con aquellos elementos que cumplan la condición especificada en el segundo parámetro.

• Ejemplos

$Filtrar([Municipios], "[#Isla]=[Gran Canaria]") <code>//devuelve una matriz de los municipios de una determinada isla, tras evaluar el campo [Isla]</code>

$Filtrar($Matriz[Representantes], "([#Tipo] = 'Secundario') y ([#Cargo] ='Directivo')")

$Ordenar

$Ordenar(M: <code>matriz, Columna: texto, Ascendente: lógico): matriz</code>

• Descripción

  Devuelve una matriz cuyas filas estarán ordenadas en función de la columna que indiquemos como parámetro. Podrán ordenarse ascendentemente (verdadero) o descendentemente (falso).

• Ejemplo

$Ordenar([Asignaturas], <code>"[#Curso]", verdadero) //devuelve una matriz con las asignaturas ordenadas por curso de forma ascendente</code>

$EliminarFilasRepetidas

$EliminarFilasRepetidas(M: <code>matriz): matriz</code>

• Descripción

  Elimina las filas repetidas de una matriz que pasamos a la función como parámetro de entrada.

• Ejemplo

$EliminarFilasRepetidas($Columnas($Matriz([Islas]),<code>"[Provincia]"));</code>

$MatrizFila

$MatrizFila(Expresion: <code>texto {, E: texto}): matriz</code>

• Descripción

  Devuelve una matriz de una sola fila, donde los valores son obtenidos de campos definidos. La expresión corresponderá a una asignación con el nombre de la columna y a continuación la expresión de un campo donde obtener el valor. La forma de la expresión es "Nombre_columna = [Campo]"

• Ejemplo

$MatrizFila("[Nombre] = [Denominación]->[Datos del promotor].[Promotor]")

$RenombrarColumnas

$RenombrarColumnas(M: <code>matriz, Actual: texto, Nuevo: texto {, A: texto, N: texto}): matriz</code>

• Descripción

  Devuelve una matriz con las columnas «Actual» renombradas por «Nuevo».

• Ejemplo

$RenombrarColumnas(M, <code>"Cod", "Código", "Den", "Denominación") //devuelve la matriz donde las columnas: "Cod" y "Den" se han renombrado por "Código" y "Denominación"</code>

$Columnas

$Columnas(M: <code>matriz, Columna: texto {, C: texto}): matriz</code>

• Descripción

  Función que devuelve una matriz con las columnas seleccionadas de otra matriz que introducimos como parámetro de entrada.

• Ejemplo

$Columnas([Municipios], <code>"[#Municipio]", "[#CodProvincia]")</code>

$AgruparSuma

$AgruparSuma(M: <code>matriz, Suma: texto, Agrupa: texto {, A: texto}): matriz</code>

• Descripción

  Devuelve una matriz donde se agruparán las filas cuando exista una coincidencia entre los valores de las columnas «Agrupa» que se especifiquen. Al encontrar una coincidencia se sumarán los valores de las celdas «Suma» de cada coincidencia y el resultado se escribirá en la celda resultante de la columna «Suma». Se creará por tanto, una sola fila, con una columna «Suma» y la fusión de las columnas cuyos valores coincidan. La matriz devuelta sólo constará de las columnas «Agrupa» y la columna «Suma», que ha de ser numérica.

• Ejemplo

$AgruparSuma(M, <code>"Importe", "Producto", "Categoría") //devuelve una matriz con las tres columnas donde siempre que coincida los valores del par «Producto» y «Categoría», los valores de «Importe» se suman</code>

$ConcatenarColumna

$ConcatenarColumna(M: <code>matriz, Columna: texto, SímboloIntermedio: texto, SímboloFinal: Texto: texto</code>

• Descripción

  Concatena los valores de todas las celdas de una columna concreta de una matriz. Habrá que especificar como parámetros de entrada la matriz, la columna, el símbolo separador y el símbolo separador de los dos últimos valores de la columna. El valor devuelto será de tipo texto con todos los valores separados por el símbolo separador, salvo los dos últimos valores, que estarán separados por el segundo símbolo separador.

• Ejemplo

$ConcatenarColumna($Matriz([Continentes]), <code>"Nombre_continente", ",", "y") //devuelve África, América, Asia, Europa y Oceanía</code>

$AsignarElemento

$AsignarElemento(M: <code>matriz, Fila: entero, Columna: texto, Valor: texto): lógico</code>

• Descripción

  Asigna un valor a una celda concreta de una tabla. Se debe especificar como parámetros de entradas la matriz, la fila, la columna y el valor que se desea asignar a la celda.

  • Fila: entero que indica la fila de la celda a modificar. Ha de tener un valor mayor o igual a 0 y menor que el número total de filas de la tabla.
  • Columna: nombre de la columna de la celda a modificar.
  • Valor: puede ser de tipo texto, vínculo, lógico, entero, fecha o variable.

  La función devuelve verdadero si se ha realizado correctamente la asignación.

  Es imprescindible que la tabla en la que se va a realizar la asignación contenga al menos una fila.

• Ejemplo

$AsignarElemento($Matriz([Continentes]), 0, <code>"[#Nombre_continente]", $Texto("Europa"))</code>