#### Previous topic

numpy.fromfunction

#### Next topic

numpy.fromstring

# numpy.fromiter

`numpy.``fromiter`(iterable, dtype, count=-1)

  Create a new 1-dimensional array from an iterable object.

  Parameters : | iterable : iterable object An iterable object providing data for the array. dtype : data-type The data-type of the returned array. count : int, optional The number of items to read from iterable. The default is -1, which means all data is read.
  Returns : | out : ndarray The output array.

  Notes

  Specify count to improve performance. It allows `fromiter` to pre-allocate the output array, instead of resizing it on demand.

  Examples

      >>> iterable = (x*x for x in range(5))
      >>> np.fromiter(iterable, np.float)
      array([  0.,   1.,   4.,   9.,  16.])