broadcast_to

broadcast_to(x: array, /, shape: Tuple[int, ...]) → array

Broadcasts an array to a specified shape.

Parameters:

• x (array) – array to broadcast. Must be capable of being broadcast to the specified shape (see Broadcasting). If the array is incompatible with the specified shape, the function must raise an exception.

• shape (Tuple[int, ...]) – array shape.

Returns:

• out (array) – an array having the specified shape. Must have the same data type as x.

• .. versionchanged:: 2024.12 – Clarified broadcast behavior.