$\texttt{contar\_todos}(tabla, campo)$

Nombre

contar_todos - Cuenta cuantos registros hay para cada valor de un campo.

Sinopsis

resumen = tablas.contar_todos(tabla, campo)

Descripcion

Recorre una TABLA y construye otra TABLA resumen que cuenta cuantos registros hay para cada valor de tabla[i][campo].

Cada registro de salida representa un valor distinto del campo agrupado y su cantidad de apariciones.

Es util para:

• resumir frecuencias por categoria
• contar repeticiones de valores dentro de un campo
• preparar datos para reportes, tablas resumen o graficos

Comportamiento

• Recorre todos los registros de la tabla de entrada.
• Si un valor ya fue agregado al resumen, incrementa su cantidad.
• Si el valor aparece por primera vez, crea un nuevo registro en la salida.
• Cada registro resultante usa el nombre del campo agrupado y un campo adicional llamado cantidad.

Funciones API relacionadas

• tablas.agrupar_por_campo()
• 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
    STRING archivo

    archivo = "personas.dat"
    CARGAR(archivo, personas, "archivo", "dat")

    // Los campos deben ser homogeneos (todos STRING, todos NUMERICO, etc)
    resumen = tablas.contar_todos(personas, "ciudad")

    tablas.imprimir(resumen)

FINAL