Documentaciónvalores_distintos(tabla, campo)

valores_distintos(tabla,campo)\texttt{valores\_distintos}(tabla, campo)

Nombre

valores_distintos - Devuelve los valores distintos encontrados en un campo de la tabla.

Sinopsis

distintos = tablas.valores_distintos(tabla, campo)

Descripcion

Recorre una TABLA y arma una subtabla con los valores no repetidos encontrados en tabla[i][campo].

En esta version soporta campos de tipo NUMERICO y STRING. El resultado siempre se devuelve como TABLA, usando un campo llamado valor para preservar el dato original.

Es util para:

  • obtener los valores unicos de una columna
  • preparar listados sin repetidos antes de agrupar o contar
  • inspeccionar rapidamente la diversidad de datos en un campo

Comportamiento

  • Detecta el tipo real del campo usando TIPO_DATO(tabla, campo).
  • Recorre todos los registros y agrega a la salida solo los valores no repetidos.
  • Devuelve una TABLA con registros del tipo {valor = ...}.
  • Si el campo no existe o tiene un tipo no soportado, produce error.

Funciones API relacionadas

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

Parámetros

ParámetroTipoDescripción
tablaTABLATabla a recorrer.
campoSTRINGCampo del cual extraer los valores distintos.

Valor de retorno

TABLA - Tabla con registros del tipo {valor = ...}.

Ejemplo

ejemplo.blox
INCLUIR "tablas.api"

FUNCION PRINCIPAL
INICIO

	TABLA    personas, retorno
	STRING   campo
    STRING   archivo

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

    campo = "ciudad"
	retorno = tablas.valores_distintos(personas, campo)

    tablas.imprimir(retorno)

FINAL