mirror of
https://github.com/golang/go.git
synced 2025-05-12 19:04:36 +00:00
3622ad9705
The notes don't define identifiers m and seq. Describe in words instead. While here, rename 3-structs.md to 4-structs.md. For #65614. Change-Id: I6690f552903d1870c70e28673c87ac84b7c5c041 Reviewed-on: https://go-review.googlesource.com/c/go/+/592195 Reviewed-by: Ian Lance Taylor <iant@google.com> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com>
30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
### Iterators
|
|
|
|
The new [iter] package provides the basic definitions for working with
|
|
user-defined iterators.
|
|
|
|
The [slices] package adds several functions that work with iterators:
|
|
- [All](/pkg/slices#All) returns an iterator over slice indexes and values.
|
|
- [Values](/pkg/slices#Values) returns an iterator over slice elements.
|
|
- [Backward](/pkg/slices#Backward) returns an iterator that loops over
|
|
a slice backward.
|
|
- [Collect](/pkg/slices#Collect) collects values from an iterator into
|
|
a new slice.
|
|
- [AppendSeq](/pkg/slices#AppendSeq) appends values from an iterator to
|
|
an existing slice.
|
|
- [Sorted](/pkg/slices#Sorted) collects values from an iterator into a
|
|
new slice, and then sorts the slice.
|
|
- [SortedFunc](/pkg/slices#SortedFunc) is like `Sorted` but with a
|
|
comparison function.
|
|
- [SortedStableFunc](/pkg/slices#SortedStableFunc) is like `SortFunc`
|
|
but uses a stable sort algorithm.
|
|
- [Chunk](/pkg/slices#Chunk) returns an iterator over consecutive
|
|
sub-slices of up to n elements of a slice.
|
|
|
|
The [maps] package adds several functions that work with iterators:
|
|
- [All](/pkg/maps#All) returns an iterator over key-value pairs from a map.
|
|
- [Keys](/pkg/maps#Keys) returns an iterator over keys in a map.
|
|
- [Values](/pkg/maps#Values) returns an iterator over values in a map.
|
|
- [Insert](/pkg/maps#Insert) adds the key-value pairs from an iterator to an existing map.
|
|
- [Collect](/pkg/maps#Collect) collects key-value pairs from an iterator into a new map and returns it.
|