1.2.6 vsip_dblockadmit_p - Admit block data

int vsip_blockadmit_f(vsip_block_f *b, vsip_scalar_bl s); 
int vsip_blockadmit_i(vsip_block_i *b, vsip_scalar_bl s); 
int vsip_blockadmit_bl(vsip_block_bl *b, vsip_scalar_bl s); 
int vsip_blockadmit_vi(vsip_block_vi *b, vsip_scalar_bl s); 
int vsip_blockadmit_mi(vsip_block_mi *b, vsip_scalar_bl s); 
int vsip_cblockadmit_f(vsip_cblock_f*, vsip_scalar_bl s);

Description

These functions admit user data to the given block b. After calling this function, the user array may no longer be manually manipulated outside of VSIPL routines. The boolean flag s indicates whether the user data should be consistent with the block data. In most cases, s should be set to VSIP_TRUE.

Parameters

• vsip_dblock_p *b: Pointer to the block to which user data is to be admitted.

• vsip_scalar_bl s: Boolean flag indicating whether the user data should be consistent with the block data.

Return Value

• Returns 0 on success.

• Returns a non-zero value on error.

Error Handling

If an error occurs, the function returns a non-zero value.

Example

vsip_block_f *float_block; 
vsip_scalar_bl consistent = VSIP_TRUE; 
int result; 
 
// Assuming float_block has been properly initialized 
result = vsip_blockadmit_f(float_block, consistent); 
 
if (result != 0) { 
    // Handle error 
}