$\texttt{promedio\_campo}(tabla, campo)$

Nombre

promedio_campo - Calcula el promedio de un campo numerico en la tabla.

Sinopsis

promedio = tablas.promedio_campo(tabla, campo)

Descripcion

Calcula el promedio de los valores de un campo numerico apoyandose en tablas.totaliza_campo().

Es util para:

• obtener medias simples de una columna numerica
• resumir rapidamente un conjunto de valores
• complementar minimos, maximos y totales del mismo campo

Comportamiento

• Obtiene primero la suma total del campo.
• Divide esa suma por tabla.dim.
• Esta funcion esta pensada para campos numericos.
• Si el campo no es valido para totaliza_campo(), la operacion produce error.

Funciones API relacionadas

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

Parámetros

Valor de retorno

NUMERICO - Promedio calculado como suma total del campo dividida por tabla.dim.

Ejemplo

INCLUIR "tablas.api"


FUNCION PRINCIPAL
INICIO

	TABLA  persona, filtrado
	NUMERICO i, total, prom
	STRING campo



    persona = {
        nombre = "Carlos",
        edad = 30,
        ciudad = "Asuncion",
    }
    persona = {
        nombre = "Juan",
        edad = 21,
        ciudad = "Encarnacion",
    }
    persona = {
        nombre = "Roberto",
        edad = 45,
        ciudad = "Concepcion",
    }
    persona = {
        nombre = "Maria",
        edad = 19,
        ciudad = "Concepcion",
    }



//
// Testado OK
//
// Copia el contenido de un campo de la tabla en un vector de string. 
//

    campo = "edad"
	total = tablas.totaliza_campo(persona, campo)
    IMPRIMIR("\nLa suma de edades en todos los registros de la tabla es: ", total)

    prom = tablas.promedio_campo(persona, campo)
    IMPRIMIR("\nEl promedio de edad en todos los registros de la tabla es: ", prom)
 
FINAL