numpy.append#

numpy.append(arr, values, axis=None)[源代码]#

将值追加到数组的末尾.

参数:
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

默认情况下,空 ndarrays 的 dtype 是 float64,因此在与 dtype int64 追加时,输出的 dtype 是 float64.