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

Nombre

contar - Cuenta cuantas veces aparece un valor en un campo de la tabla.

Sinopsis

total = tablas.contar(tabla, campo, valor)

Descripcion

Recorre una TABLA y cuenta cuántos registros cumplen la comparación tabla[i][campo] == valor.

Es util para:

• medir la frecuencia de un valor concreto
• apoyar agrupaciones o filtros posteriores
• validar cuantas coincidencias existen en un campo

Comportamiento

• Recorre todos los registros de la tabla.
• Incrementa el contador cuando encuentra una coincidencia exacta.
• Devuelve el total acumulado como NUMERICO.

Funciones API relacionadas

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

NUMERICO - Cantidad total de registros para los cuales tabla[i][campo] == valor.

Ejemplo

INCLUIR "tablas.api"


FUNCION PRINCIPAL
INICIO
    TABLA personas
    NUMERICO i, cant

    // 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"}

    cant = tablas.contar(personas, "ciudad", "CDE")

    IMPRIMIR("En CDE hay: ", cant:0, "personas.\n")

FINAL