$\texttt{agrupar\_por\_campo}(tabla, campo)$

Nombre

agrupar_por_campo - Alias semantico de tablas.contar_todos().

Sinopsis

resumen = tablas.agrupar_por_campo(tabla, campo)

Descripcion

Mantiene el nombre historico de esta operacion y devuelve una TABLA resumen con la cantidad de registros para cada valor del campo indicado.

Se conserva por compatibilidad con codigo existente, pero la forma preferida en esta API es tablas.contar_todos().

Comportamiento

• Delega el trabajo en tablas.contar_todos(tabla, campo).
• Devuelve una tabla con el mismo formato de salida.
• No modifica la tabla original.

Funciones API relacionadas

• tablas.contar_todos()
• tablas.contar()
• tablas.valores_distintos()
• tablas.buscar_distintos()
• tablas.max_en_campo()
• tablas.min_en_campo()
• tablas.totaliza_campo()
• tablas.promedio_campo()

Parámetros

Valor de retorno

TABLA - Tabla resumen con registros del tipo {<campo> = valor, cantidad = n}.

Ejemplo

INCLUIR "tablas.api"
INCLUIR "strings.api"


FUNCION PRINCIPAL
INICIO
    TABLA personas, resumen
    NUMERICO i, cant, sts

    // Cargar datos de prueba
    personas = {nombre = "Ana", ciudad = "Asuncion"}
    personas = {nombre = "Luis", ciudad = "CDE"}
    personas = {nombre = "Maria", ciudad = "Asuncion"}
    personas = {nombre = "Jose", ciudad = "Encarnacion"}
    personas = {nombre = "Laura", ciudad = "CDE"}
    personas = {nombre = "Pedro", ciudad = "Asuncion"}

    resumen = tablas.agrupar_por_campo(personas, "ciudad")    
    //resumen = tablas.agrupar_por_campo1(personas, "ciudad")

    tablas.imprimir(resumen)

FINAL