Package Usage: go: github.com/jkeiser/iter

Generic forward-only iterator that is safe and leak-free. This package is intended to support forward-only iteration in a variety of use cases while avoiding the normal errors and leaks that can happen with iterators in Go. It provides mechanisms for map/select filtering, background iteration through a goroutine, and error handling throughout. The type of the iterator is interface{}, so it can store anything, at the cost that you have to cast it back out when you use it. This package can be used as is, or used as an example for creating your own forward-only iterators of more specific types. With the lack of generics and a builtin iterator pattern, iterators have been the topic of much discussion in Go. Here are the discussions that inspired this: http://ewencp.org/blog/golang-iterators/: Ewan Cheslack-Postava's discussion of the major iteration patterns. Herein we have chosen the closure pattern for iterator implementation, and given the choice of callback and channel patterns for iteration callers. http://blog.golang.org/pipelines: A March 2014 discussion of pipelines on the go blog presents some of the pitfalls of channel iteration, suggesting the "done" channel implementation to compensate. Simple error- and cleanup-free iterators can be easily created: Typically you will create iterators in packages ("please iterate over this complicated thing"). You will often handle errors and have cleanup to do. iter supports both of these. You can create a fully-functional iterator thusly: Callback iteration looks like this and handles any bookkeeping automatically: Sometimes you need to handle errors: Raw iteration looks like this: Background goroutine iteration (using channels) deserves special mention: There are several useful functions provided to work with iterators:
1 version
Latest release: almost 4 years ago
6 dependent packages

View more package details: https://packages.ecosyste.ms/registries/proxy.golang.org/packages/github.com/jkeiser/iter

View more repository details: https://repos.ecosyste.ms/hosts/GitHub/repositories/jkeiser%2Fiter

Dependent Repos 41