Documentaciónvalores_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
TABLAcon 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ámetro | Tipo | Descripción |
|---|---|---|
| tabla | TABLA | Tabla a recorrer. |
| campo | STRING | Campo 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