putarray¶
Purpose¶
Puts a contiguous subarray into an N-dimensional array and returns the resulting array.
Format¶
-
y =
putarray
(dest, loc, src)¶ - Parameters:
dest (N-dimensional array) – destination data
loc (Mx1 vector) – indices into the array to locate the subarray of interest, where M is a value from 1 to N.
src ([N-M]-dimensional array or matrix or scalar.) – source data
- Returns:
y (N-dimensional array) – resulting array with destination data in a inserted into the source data.
Examples¶
// Create a 2x3x4x5x6 dimensional array with unspecified
// contents
dest = arrayalloc(2|3|4|5|6, 0);
// Create a 4x5x6 dimensional array with all elements equal
// to 5
src = arrayinit(4|5|6, 5);
loc = { 2, 1 };
a = putarray(dest, loc, src);
This example sets the contiguous 4x5x6 subarray of dest beginning at [2,1,1,1,1] to the array src, in which each element is set to the specified value 5.
Remarks¶
If loc is an Nx1 vector, then src must be a scalar. If loc is an [N-1]x1 vector, then src must be a 1-dimensional array or a 1xL vector, where L is the size of the fastest moving dimension of the array. If loc is an [N-2]x1 vector, then src must be a KxL matrix, or a KxL 2-dimensional array, where K is the size of the second fastest moving dimension.
Otherwise, if loc is an Mx1 vector, then src must be an [N-M]-dimensional array, whose dimensions are the same size as the corresponding dimensions of array dest.
See also
Functions setarray