Iterator

gto76 · gto76 · commit e31ad08fba6b · 2019-02-27T15:36:49.000+01:00
diff --git a/README.md b/README.md
@@ -169,11 +169,37 @@ Point(x=1, y=2)
 
 Iterator
 --------
+* **If you want to print the iterator, you need to pass it to the list() function.**
+* **In this cheatsheet `'<collection>'` can also mean an iterator.**
+
+```python
+from itertools import islice, count, repeat, cycle, chain
+```
+
 ```python
 <iter> = iter(<collection>)
-<iter> = iter(<function>, to_exclusive)
+<iter> = iter(<function>, to_exclusive)     # Sequence of return values until 'to_exclusive'.
+<el>   = next(<iter> [, default])           # Raises StopIteration or returns 'default' on end.
+```
+
+```python
+<iter> = islice(<collection>, to_exclusive)
+<iter> = islice(<collection>, from_inclusive, to_exclusive)
+<iter> = islice(<collection>, from_inclusive, to_exclusive, step_size)
 ```
 
+```python
+<iter> = count(start=0, step=1)             # Returns incremented integer endlessly.
+<iter> = repeat(<el> [, times])             # Returns element endlessly or 'times' times.
+<iter> = cycle(<collection>)                # Repeats the sequence indefinitely.
+```
+
+```python
+<iter> = chain(<collection>, <collection>)  # Empties collections in order.
+<iter> = chain.from_iterable(<collection>)  # Empties collections inside a collection in order.
+```
+
+### Examples
 #### Reads input until it reaches an empty line:
 ```python
 for line in iter(input, ''):
@@ -187,12 +213,6 @@ for line in iter(partial(input, 'Please enter value: '), ''):
     ...
 ```
 
-### Next
-**Returns next item. If there are no more items it raises StopIteration exception or returns default if specified.**
-```python
-<el> = next(<iter> [, default])
-```
-
 #### Skips first item:
 ```python
 next(<iter>)
@@ -219,33 +239,6 @@ def count(start, step):
 ```
 
 
-Itertools
----------
-* **Every function returns an iterator and can accept any collection and/or iterator.**
-* **If you want to print the iterator, you need to pass it to the list() function!**
-
-```python
-from itertools import islice, count, repeat, cycle, chain
-```
-
-```python
-<iter> = islice(<collection>, to_exclusive)
-<iter> = islice(<collection>, from_inclusive, to_exclusive)
-<iter> = islice(<collection>, from_inclusive, to_exclusive, step_size)
-```
-
-```python
-<iter> = count(start=0, step=1)             # Counter.
-<iter> = repeat(<el> [, times])             # Returns element endlessly or times times.
-<iter> = cycle(<collection>)                # Repeats the sequence indefinitely.
-```
-
-```python
-<iter> = chain(<collection>, <collection>)  # Empties sequences in order.
-<iter> = chain.from_iterable(<collection>)  # Empties sequences inside a sequence in order.
-```
-
-
 Type
 ----
 ```python
