numpy.broadcast_to

numpy.broadcast_to(array, shape, subok=False)

将数组广播到新的形状。

参数：

arrayarray_like

要广播的数组。

shape元组或整数

所需数组的形状。单个整数 i 被解释为 (i,)。

subok布尔值，可选

如果为 True，则子类将被传递，否则返回的数组将强制为基类数组（默认值）。

返回值：

broadcast数组

具有给定形状的原始数组的只读视图。它通常不连续。此外，广播数组的多个元素可能引用单个内存位置。

引发：

ValueError

如果数组根据 NumPy 的广播规则与新形状不兼容。

参见

broadcast

broadcast_arrays

broadcast_shapes

备注

版本 1.10.0 中的新功能。

示例

>>> import numpy as np
>>> x = np.array([1, 2, 3])
>>> np.broadcast_to(x, (3, 3))
array([[1, 2, 3],
       [1, 2, 3],
       [1, 2, 3]])