Collections Activities

Versión: 1.0.3  ·  ID: zoan-packages-collections  ·  Autor: Zoan Software

El paquete Collections crea y manipula los dos tipos de colección más usados: listas (secuencias de elementos) y diccionarios (pares clave→valor). Sirve para acumular resultados, llevar registros, agrupar datos relacionados o configurar opciones.

Antes de empezar

Conviene conocer estos dos tipos de datos: una lista es una secuencia ordenada (["Ana", "Luis"]); un diccionario asocia claves a valores ({ "ciudad": "Bogotá", "edad": 30 }). Los índices de lista empiezan en 0.

Actividad o expresión: las dos formas

Casi todo lo que hacen estas actividades tiene también un equivalente directo en una expresión. Por ejemplo:

Quieres…	Actividad	Equivalente en expresión
Contar elementos	List Count	count(lista) o lista.Count
Elemento por índice	Get List Item	lista[0]
¿Contiene?	List Contains	lista.Contains(valor)
Valor de una clave	Get Dictionary Value	d["clave"] (o dictGet(d, "clave"), que da null si la clave no existe en vez de fallar)
Agregar a lista	Add to List	listAdd(lista, valor)

¿Cuál usar? Las actividades hacen el flujo más explícito y visual (útil para quien recién empieza). Las expresiones son más breves y cómodas cuando ya estás dentro de otra fórmula. Ambas son correctas — elige según prefieras claridad o concisión. Ver Expresiones › Colecciones.

Dónde queda el resultado

Las actividades que devuelven un resultado (crear, contar, obtener, comprobar) lo entregan por el campo de salida de la actividad, como el resto de actividades: eliges allí la variable que lo recibe (→ output: variable en los ejemplos). Las que modifican una colección (agregar, asignar, quitar, vaciar) la cambian en sitio y no devuelven nada: cualquier variable que apunte a esa lista o diccionario ve el cambio.

Actividades

Listas

Actividad	Tipo	Salida	Qué hace
Create List	list-create	List	Crea una lista, vacía o con elementos iniciales
Add to List	list-add	—	Agrega un elemento
Get List Item	list-get	object	Elemento por índice
List Count	list-count	int	Número de elementos
List Contains	list-contains	bool	¿Contiene un elemento?
Remove from List	list-remove-at	—	Elimina por índice
Clear List	list-clear	—	Vacía la lista

Diccionarios

Actividad	Tipo	Salida	Qué hace
Create Dictionary	dict-create	Dictionary	Crea un diccionario, vacío o con pares iniciales
Set Dictionary Value	dict-set	—	Asigna/actualiza una clave
Get Dictionary Value	dict-get	object	Valor de una clave
Dictionary Contains Key	dict-contains-key	bool	¿Existe la clave?
Dictionary Count	dict-count	int	Número de pares
Get Dictionary Keys	dict-keys	List	Todas las claves
Remove Dictionary Key	dict-remove	—	Elimina una clave

Siguientes pasos

• Create List / Create Dictionary — crear una colección.
• Tipos de datos › Colecciones — sus propiedades y métodos.
• Expresiones › Colecciones — la alternativa en una sola línea.