6.3 vsip_dvsubview_p - Create a Subview of a Vector View

vsip_vview_f* vsip_vsubview_f(const vsip_vview_f* v, vsip_index j, vsip_length n); 
vsip_vview_d* vsip_vsubview_d(const vsip_vview_d* v, vsip_index j, vsip_length n); 
vsip_cvview_f* vsip_cvsubview_f(const vsip_cvview_f* v, vsip_index j, vsip_length n); 
vsip_cvview_d* vsip_cvsubview_d(const vsip_cvview_d* v, vsip_index j, vsip_length n);

Description

This function creates a subview of an existing vector view v, starting from the index j and extending for n elements. The subview provides a view into a subset of the original vector view.

Parameters

• const vsip_dvview_p* v: Pointer to the original vector view from which the subview will be created.

• vsip_index j: Starting index within the original vector view for the subview.

• vsip_length n: The number of elements in the subview.

Return Value

• On success, a pointer to the newly created subview object is returned.

• On error, NULL is returned.

Error Handling

If an error occurs, the function returns NULL.

Example

vsip_vview_f *original_view; 
vsip_index start_index = 5; 
vsip_length subview_length = 10; 
vsip_vview_f *subview; 
 
// Assuming original_view has been properly initialized 
subview = vsip_vsubview_f(original_view, start_index, subview_length); 
 
if (subview == NULL) { 
    // Handle error 
} 
 
// The subview is now a view into a subset of the original vector view