Files
Nate Cook 4f53c9cf40 Finish sub-page documentation updates (#204)
* Finish sub-page documentation updates

Some of these pages could use introductions, but the current state is
ready for publication.

* Add SPI yaml file for building docs
2023-10-05 13:10:03 -05:00

1.2 KiB

Chunking

Break collections into consecutive chunks by length, count, or based on closure-based logic.

Overview

Chunking is the process of breaking a collection into consecutive subsequences, without dropping or duplicating any of the collection's elements. After chunking a collection, joining the resulting subsequences produces the original collection of elements, unlike splitting, which consumes the separator element(s).

let names = ["Ji-sun", "Jin-su", "Min-jae", "Young-ho"]
let evenlyChunked = names.chunks(ofCount: 2)
// ~ [["Ji-sun", "Jin-su"], ["Min-jae", "Young-ho"]] 

let chunkedByFirstLetter = names.chunked(on: \.first)
// equivalent to [("J", ["Ji-sun", "Jin-su"]), ("M", ["Min-jae"]), ("Y", ["Young-ho"])]

Topics

Chunking a Collection by Count

  • Swift/Collection/chunks(ofCount:)
  • Swift/Collection/evenlyChunked(in:)

Chunking a Collection by Predicate

  • Swift/Collection/chunked(by:)
  • Swift/LazySequenceProtocol/chunked(by:)

Chunking a Collection by Subject

  • Swift/Collection/chunked(on:)
  • Swift/LazySequenceProtocol/chunked(on:)

Supporting Types

  • ChunkedByCollection
  • ChunkedOnCollection
  • ChunksOfCountCollection
  • EvenlyChunkedCollection