Coroutine basics (IEnumerator) in Unity - Step-by-Step Execution

Concept Flow - Coroutine basics (IEnumerator)

Start Coroutine

↓

Execute IEnumerator Step

↓

Yield return Wait or null?

↓

Pause Execution

↓

Check if more steps

Yes↓

Execute Next IEnumerator Step

No↓

Coroutine Ends

The coroutine starts and runs each step of the IEnumerator. When it hits a yield, it pauses and resumes later until all steps finish.

Execution Sample

Unity

IEnumerator ExampleCoroutine() {
  Debug.Log("Start");
  yield return null;
  Debug.Log("After one frame");
  yield return new WaitForSeconds(1);
  Debug.Log("After 1 second");
}

This coroutine logs messages, waits one frame, then waits one second before finishing.

Execution Table

Step	Action	Yield Returned	Coroutine Paused?	Output
1	Start coroutine, run first Debug.Log	null	Yes (wait one frame)	Start
2	Resume after one frame, run second Debug.Log	WaitForSeconds(1)	Yes (wait 1 second)	After one frame
3	Resume after 1 second, run third Debug.Log	none	No (coroutine ends)	After 1 second

💡 Coroutine ends after all steps run and no more yield statements.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3
Coroutine State	Not started	Paused (yield null)	Paused (yield WaitForSeconds)	Finished

Key Moments - 3 Insights

Why does the coroutine pause after 'yield return null'?

Because 'yield return null' tells Unity to pause the coroutine and resume it in the next frame, as shown in execution_table step 1.

What happens when the coroutine yields 'WaitForSeconds(1)'?

The coroutine pauses for 1 second before continuing, as seen in execution_table step 2 where it waits before running the next Debug.Log.

When does the coroutine actually end?

It ends after the last Debug.Log runs and there is no more yield, shown in execution_table step 3 where 'Coroutine Paused?' is No.

Visual Quiz - 3 Questions

Look at the execution_table, what is the coroutine state after step 2?

A Finished

B Paused waiting for 1 second

C Running without pause

D Paused waiting for next frame

💡 Hint

Check 'Coroutine Paused?' and 'Yield Returned' columns in execution_table row 2.

At which step does the coroutine stop pausing and finish?

A Step 3

B Step 2

C Step 1

D It never finishes

💡 Hint

Look at 'Coroutine Paused?' column in execution_table to find when it says 'No'.

If we remove 'yield return null', what changes in the execution_table?

A Coroutine pauses for one frame at step 1

B Coroutine pauses for 1 second at step 1

C First two Debug.Logs run immediately, then pause for 1 second

D Coroutine never starts

💡 Hint

Refer to how 'yield return null' causes pause in execution_table step 1.

Concept Snapshot

Coroutine basics with IEnumerator in Unity:
- Coroutine runs code step-by-step.
- 'yield return null' pauses until next frame.
- 'yield return WaitForSeconds(x)' pauses for x seconds.
- Coroutine resumes after each yield until done.
- Use Debug.Log to see execution order.

Full Transcript

This visual trace shows how a Unity coroutine using IEnumerator runs step-by-step. The coroutine starts and runs the first Debug.Log, then pauses because of 'yield return null' until the next frame. After resuming, it logs again and pauses for 1 second due to 'yield return new WaitForSeconds(1)'. Finally, it logs the last message and ends because there are no more yield statements. Variables track the coroutine state as Not started, Paused, and Finished. Key moments clarify why the coroutine pauses and when it ends. The quiz tests understanding of pause points and coroutine flow.