vsip_dmcloneview_p - Clone a Matrix View

Core

This manual is preliminary and incomplete.
While our Core implementation implements all functions given in the standard we are still working on completing this documentation.

Please refer to the VSIPL standard for a complete function reference of the Core profile until we have completed work on this documentation.

[next] [prev] [prev-tail] [tail] [up]

1.4.3 vsip_dmcloneview_p - Clone a Matrix View

vsip_mview_f* vsip_mcloneview_f(const vsip_mview_f* matrix); 
vsip_cmview_f* vsip_cmcloneview_f(const vsip_cmview_f* matrix);

Description

This function creates a new matrix view that shares the same data block as the input matrix view but has its own independent view parameters. The cloned view references the same underlying data but maintains its own metadata (dimensions, strides, offset).

This is useful when you need multiple independent views of the same data, or when you want to create a view with different parameters (like different submatrix boundaries) while sharing the same data storage.

Parameters

const vsip_dmview_p* matrix: Pointer to the source matrix view to be cloned.

Return Value

On success, returns a pointer to the newly created matrix view that shares data with the input view.
On error, returns NULL.

Example

vsip_mview_f *original_matrix; 
vsip_mview_f *cloned_matrix; 
 
// Clone the matrix view 
cloned_matrix = vsip_mcloneview_f(original_matrix); 
 
if (cloned_matrix == NULL) { 
    // Handle error 
}

Notes

The cloned view shares the same underlying data block as the original view.
Changes to the data through one view will be visible through all other views that share the same data block.
The cloned view has the same dimensions, strides, and offset as the original view.
This function is useful for creating multiple independent views of the same data without copying the actual data.
To create a completely independent copy (including the data), use vsip_dmcopy_p_p to copy to a new matrix.

[next] [prev] [prev-tail] [front] [up]