mindspore.dataset.Dataset.create_dict_iterator
==============================================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/master/resource/_static/logo_source.svg
    :target: https://atomgit.com/mindspore/mindspore/blob/master/docs/api/api_python/dataset/dataset_method/iterator/mindspore.dataset.Dataset.create_dict_iterator.rst
    :alt: 查看源文件


.. py:method:: mindspore.dataset.Dataset.create_dict_iterator(num_epochs=-1, output_numpy=False, do_copy=False)

    创建数据集迭代器，返回字典形式的样本，其中键为列名，值为数据。

    参数：
        - **num_epochs** (int, 可选) - 数据集迭代次数。默认值： ``-1`` ，表示数据集可以无限迭代。
        - **output_numpy** (bool, 可选) - 是否保持输出数据类型为 NumPy 数组。默认值： ``False`` ，表示将非字符串类型数据转换为 :class:`mindspore.Tensor` 。
        - **do_copy** (bool, 可选) - 指定转换输出类型为 :class:`mindspore.Tensor` 时是否拷贝数据。仅当 `output_numpy` 为 ``False`` 时有效。默认值： ``False`` ，表示直接复用数据缓冲区以获得更好的性能。

    返回：
        Iterator，字典形式样本的迭代器。