code: public static <M extends Map<K, V>, K, V> M dict(Iterator<Pair<K, V>> iterator, M map) {
          dbc.precondition(map != null, "cannot call dict with a null map");
          final Function<Iterator<Pair<K, V>>, M> consumer = new ConsumeIntoMap<>(new ConstantSupplier<M>(map));
          return consumer.apply(iterator);
      }
docs: Yields all elements of the iterator (in the provided map).
  
  @param <M> the returned map type
  @param <K> the map key type
  @param <V> the map value type
  @param iterator the iterator that will be consumed
  @param map the map where the iterator is consumed
  @return the map filled with iterator values