numpy.append#

numpy.append(arr, values, axis=None)[source]#

将值追加到数组的末尾。

参数:
arrarray_like

值将追加到此数组的副本。

valuesarray_like

这些值将追加到 arr 的副本。它必须具有正确的形状(与 arr 的形状相同,不包括 axis)。如果未指定 axis,则 values 可以是任何形状,并在使用前会被展平。

axisint, 可选

追加 values 的轴。如果未给出 axis,则 arrvalues 都会在使用前被展平。

返回值:
appendndarray

具有追加到 axis 上的 valuesarr 的副本。请注意,append 不会就地发生:会分配一个新的数组并填充它。如果 axis 为 None,则 out 是一个展平的数组。

另请参阅

insert

将元素插入数组。

delete

从数组中删除元素。

示例

>>> import numpy as np
>>> np.append([1, 2, 3], [[4, 5, 6], [7, 8, 9]])
array([1, 2, 3, ..., 7, 8, 9])

当指定 axis 时,values 必须具有正确的形状。

>>> np.append([[1, 2, 3], [4, 5, 6]], [[7, 8, 9]], axis=0)
array([[1, 2, 3],
       [4, 5, 6],
       [7, 8, 9]])
>>> np.append([[1, 2, 3], [4, 5, 6]], [7, 8, 9], axis=0)
Traceback (most recent call last):
    ...
ValueError: all the input arrays must have same number of dimensions, but
the array at index 0 has 2 dimension(s) and the array at index 1 has 1
dimension(s)
>>> a = np.array([1, 2], dtype=int)
>>> c = np.append(a, [])
>>> c
array([1., 2.])
>>> c.dtype
float64

空 ndarray 的默认 dtype 为 float64,因此当与 dtype int64 追加时,输出的 dtype 为 float64