Add example specs for Take and Drop

Author: BooleanCat

iter/drop_test.go

@@ -1,12 +1,19 @@
 package iter_test
 
 import (
+	"fmt"
 	"testing"
 
 	"github.com/BooleanCat/go-functional/internal/assert"
 	"github.com/BooleanCat/go-functional/iter"
 )
 
+func ExampleDrop() {
+	counter := iter.Drop[int](iter.Count(), 2)
+	fmt.Println(counter.Next().Unwrap())
+	// Output: 2
+}
+
 func TestDrop(t *testing.T) {
 	counter := iter.Drop[int](iter.Count(), 2)
 	assert.Equal(t, counter.Next().Unwrap(), 2)

iter/take_test.go

@@ -1,12 +1,24 @@
 package iter_test
 
 import (
+	"fmt"
 	"testing"
 
 	"github.com/BooleanCat/go-functional/internal/assert"
 	"github.com/BooleanCat/go-functional/iter"
 )
 
+func ExampleTake() {
+	iter := iter.Take[int](iter.Count(), 2)
+	fmt.Println(iter.Next())
+	fmt.Println(iter.Next())
+	fmt.Println(iter.Next())
+	// Output:
+	// Some(0)
+	// Some(1)
+	// None
+}
+
 func TestTakeIter(t *testing.T) {
 	iter := iter.Take[int](iter.Count(), 2)
 	assert.Equal(t, iter.Next().Unwrap(), 0)