{{alias}}( ...arrays ) Broadcasts ndarrays to a common shape. The function supports two (mutually exclusive) means of providing ndarray arguments: 1. Providing a single array containing ndarray arguments. 2. Providing ndarray arguments as separate arguments. If a provided ndarray has a shape matching the common shape, the function returns the provided ndarray. If a provided ndarray has a different (broadcast compatible) shape than the common shape, the function returns a new *read-only* ndarray view of the provided ndarray's data. The view is typically *not* contiguous. As more than one element of a returned view may refer to the same memory location, writing to a view may affect multiple elements. If you need to write to an input ndarray, copy the input ndarray before broadcasting. The function throws an error if a provided broadcast-incompatible ndarrays. Parameters ---------- arrays: ...ndarray|ArrayLikeObject Array arguments. Returns ------- out: Array Broadcasted arrays. Examples -------- > var x = {{alias:@stdlib/ndarray/array}}( [ [ 1, 2 ], [ 3, 4 ] ] ) > var sh = x.shape [ 2, 2 ] > var y = {{alias:@stdlib/ndarray/zeros}}( [ 3, 2, 2 ] ) > var out = {{alias}}( [ x, y ] ) [ , ] // Retrieve the broadcasted "x" array: > var bx = out[ 0 ] > sh = bx.shape [ 3, 2, 2 ] // Retrieve broadcasted elements... > var v = bx.get( 0, 0, 0 ) 1 > v = bx.get( 0, 0, 1 ) 2 > v = bx.get( 0, 1, 0 ) 3 > v = bx.get( 0, 1, 1 ) 4 > v = bx.get( 1, 0, 0 ) 1 > v = bx.get( 1, 1, 0 ) 3 > v = bx.get( 2, 0, 0 ) 1 > v = bx.get( 2, 1, 1 ) 4 See Also --------