Chapters
Chapters

Chapters

Hide chapters

Kotlin Coroutines by Tutorials

Third Edition · Android 12 · Kotlin 1.6 · Android Studio Bumblebee

Before You Begin

Section 0: 6 chapters
Show chapters Hide chapters

Section I: Introduction to Coroutines

Section 1: 9 chapters
Show chapters Hide chapters

Section II: Channels & Flows

Section 2: 4 chapters
Show chapters Hide chapters

Section III: Coroutines & Android

Section 3: 6 chapters
Show chapters Hide chapters

10. Building Sequences & Iterators With Yield
Written by Filip Babić

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

Heads up... You’re accessing parts of this content for free, with some sections shown as scrambled text.

Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now

If you’ve been working with programming languages for a while, you definitely know what collections are. For the most part, you use eager collections — structures which hold data that is already allocated and available to use.

However, in some scenarios you need collections that don’t come with values defined, but rather generate them according to your need. These structures are called sequences. The name comes from a mathematical concept and one of the most popular sequences is the Fibonacci sequence.

It defines the following numbers:

0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89, 144...

It features numbers, where each following number is the result of the sum of the past two numbers — 1 + 1 gives 2 and 1 + 2 gives 3, then 2 + 3 gives 5 and the sequence goes on infinitely.

These are also the two main aspects of each sequence:

  1. Its values are defined by a strict rule. Most of the time it’s based on mathematical assumptions.
  2. All sequences can produce infinite values, based on their rule.

Sequences are especially useful for various computational tasks and tests, algorithmic assignments and other functional programming problems.

Let’s see how to build them using Kotlin Coroutines.

Getting Started With Sequences

To follow along the code in this chapter, open this chapter’s project using IntelliJ, by pressing Open project. Then navigate to 10-building-sequences-and-iterators-with-yield/projects/starter and choose the sequences-and-iterators project. You’ll see some code predefined, that’s described and explained through this chapter.

Let’s start with iterators first.

Iterating Over Values

Kotlin provides many ways to manage collections of data with a well-defined Collections API together with many functional operators at your disposal.

Enter: Sequence

To overcome such performance bottleneck issues, Kotlin exposes another data structure called Sequence, which handles the collection of items in a lazy evaluated manner. The items processed in a sequence are not evaluated until you access them. They are great at representing collection where the size isn’t known in advance, like reading lines from a file.

Generators & Sequences

Using Coroutines with sequences, it is possible to implement generators. Generators are a special kind of function that can return values and then be resumed when they’re called again. Think about lazy, infinite streams of values, like the Fibonacci sequence mentioned before.

Yielding From SequenceScope

When working with Coroutines, you need to define a scope within which the coroutines or suspension functions will work. SequenceScope is defined for the same reason, for yielding values of a Sequence or an Iterator using suspending functions or coroutines.

Providing Values With Yield & YieldAll

Using yield, there are various ways by which a generator function can be written to handle infinite collections of data.

Key Points

  1. Collections are eagerly evaluated; i.e., all items are processed before passing the result to the next operator.
  2. Sequences handle the collection of items in a lazy-evaluated manner; i.e., the items in it are not evaluated or allocated until you access them.
  3. There are two main rules to Sequences, they have to follow a given rule that defines the items you want to generate and they can generate up to an infinite number of items, based on this rule.
  4. Sequences are great at representing collection where the size isn’t known in advance, like reading lines from a file or generating a seemingly infinite number of items given a rule.
  5. asSequence can be used to convert a List to a sequence.
  6. It is recommended to use simple Iterables in most cases. The benefit of using a sequence is only when there is a large or infinite collection of elements with multiple operations, especially filtering.
  7. Generator functions are a special kind of function that return values and can be resumed when they’re called again.
  8. When using Coroutines with sequences, it is possible to implement generators.
  9. SequenceScope is defined for yielding values of a Sequence or an Iterator using suspending functions or Coroutines.
  10. SequenceScope provides yield and yieldAll suspending functions to enable generator function behavior.

Where to Go From Here?

Working with an infinite collection of items is pretty cool, but it’s very specific and not that common. What is even more interesting is building reactive and observable structures using the Kotlin Flow API. You’ll learn about those in the next chapter.

9. Manage Cancellation
11. Beginning With Coroutine Flow
Have a technical question? Want to report a bug? You can ask questions and report bugs to the book authors in our official book forum here.
© 2026 Kodeco Inc.

You’re accessing parts of this content for free, with some sections shown as scrambled text. Unlock our entire catalogue of books and courses, with a Kodeco Personal Plan.

Unlock now