# StartLoop

El nodo Start Loop inicia una estructura de bucle dentro de un flujo de trabajo. Ejecuta el cuerpo del bucle conectado una vez por iteración y puede contar las iteraciones de tres maneras: un número fijo de repeticiones (simple), un rango de índices numéricos (For) o una pasada por cada elemento de una lista (List). Cada pasada expone el índice actual, indicadores de primero/último y un valor transportado opcional que puede pasarse de una iteración a la siguiente.

## Entradas

### Entradas comunes

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
|-----------|-------------|---------------|-------------|-------|
| `modo` | El modo de iteración del bucle (predeterminado: "simple"). El modo seleccionado determina qué parámetros adicionales se muestran. | DYNAMIC_COMBO | Sí | `"simple"`<br>`"For"`<br>`"List"` |
| `cache_iterations` | Reutiliza los resultados de iteraciones sin cambios de ejecuciones anteriores. Desactívalo para volver a ejecutar cada iteración. Predeterminado: false. | BOOLEAN | Sí | true<br>false |
| `parent_iteration` | Conecta iteration_index desde un Start Loop externo para anidar este bucle. Esta entrada es solo de entrada forzada (se requiere un enlace). | INT | No | Cualquier entero |
| `initial_iteration_value` | Valor expuesto como current_iteration_value en la primera iteración. | ANY (tipo coincidente) | No | Cualquier valor |

### Entradas del modo Simple

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
|-----------|-------------|---------------|-------------|-------|
| `num_iterations` | Número de veces que se ejecuta el cuerpo del bucle. Predeterminado: 4. | INT | Sí | Mínimo 0 |

### Entradas del modo For

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
|-----------|-------------|---------------|-------------|-------|
| `start_iteration_index` | Índice de la primera iteración cuando se usa el modo de bucle For. Predeterminado: 0. | INT | Sí | Cualquier entero |
| `max_iteration` | Valor de detención exclusivo para iteration_index en el modo For. Predeterminado: 4. | INT | Sí | Máximo 0xffffffffffffffff |
| `step` | Tamaño del paso de índice entre cada iteración cuando se usa el modo de bucle For. Predeterminado: 1. | INT | Sí | Mínimo 1 |

### Entradas del modo List

| Parámetro | Descripción | Tipo de datos | Obligatorio | Rango |
|-----------|-------------|---------------|-------------|-------|
| `list` | Lista de elementos sobre los que itera el bucle. El cuerpo del bucle se ejecuta una vez por elemento. | ANY (elemento de lista coincidente con el tipo) | Sí | Cualquier lista |

Notas:

- Solo se muestran y se usan los parámetros que pertenecen al `mode` seleccionado actualmente.
- En el modo Simple, los índices de iteración van de 0 hasta `num_iterations` menos 1. En el modo For, los índices van de `start_iteration_index` hasta (pero sin incluir) `max_iteration`, incrementándose en `step`. En el modo List, se ejecuta una iteración por cada elemento de `list`.
- `step` no debe ser 0; un valor de 0 genera un error. No se permiten valores menores que 1.
- Si el número calculado de iteraciones es cero, la salida `is_last` se informa como verdadero y el cuerpo del bucle no se ejecuta.

## Salidas

| Nombre de salida | Descripción | Tipo de datos |
|------------------|-------------|---------------|
| `iteration_index` | Índice de la iteración actual del bucle. | INT |
| `is_first` | Verdadero durante la primera iteración del bucle. | BOOLEAN |
| `is_last` | Verdadero durante la última iteración del bucle. | BOOLEAN |
| `list_item` | Elemento actual de la lista cuando se usa el modo List. Ninguno en los modos Simple y For. | ANY (tipo coincidente) |
| `current_iteration_value` | Valor transportado por el bucle para la iteración actual: initial_iteration_value en la primera iteración, luego next_iteration_value de End Loop en cada iteración posterior. | ANY (tipo coincidente) |

> Esta documentación fue generada por IA. Si encuentra algún error o tiene sugerencias de mejora, ¡no dude en contribuir! [Editar en GitHub](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/StartLoop/es.md)

---
**Source fingerprint (SHA-256):** `be34fedd4db9d4f4cc795855c87f6489f294e029da316b5dc66e5af7dff004a9`
