# numpy.lib.format.write_array

lib.format.write_array(fp, array, version=None, allow_pickle=True, pickle_kwargs=None)

  Write an array to an NPY file, including a header.

  If the array is neither C-contiguous nor Fortran-contiguous AND the file_like object is not a real file object, this function will have to copy data in memory.

  Parameters
    fp file_like object

      An open, writable file object, or similar object with a `.write()` method.

    array ndarray

      The array to write to disk.

    version(int, int) or None, optional

      The version number of the format. None means use the oldest supported version that is able to store the data. Default: None

    allow_pickle bool, optional

      Whether to allow writing pickled data. Default: True

    pickle_kwargs dict, optional

      Additional keyword arguments to pass to pickle.dump, excluding ‘protocol’. These are only useful when pickling objects in object arrays on Python 3 to Python 2 compatible format.

  Raises
    ValueError

      If the array cannot be persisted. This includes the case of allow_pickle=False and array being an object array.

    Various other errors

      If the array contains Python objects as part of its dtype, the process of pickling them may raise various errors if the objects are not picklable.

previous

numpy.lib.format.read_magic

next

numpy.lib.format.write_array_header_1_0