Next: , Previous: Internal Functions, Up: Internal Functions


A.5.1 bpipe_check_matrix_copy

Ensure that a matrix copy request is legal.

Synopsis

     #include <bpipe/bpipe.h>
     
     
     
int bpipe_check_matrix_copy( BPMatrix *src, BPMatrix *dst, BPMatrixMap *map );

Parameters

BPMatrix *src
description of the source matrix
BPMatrix *dst
description of the destination matrix
BPMatrixMap *map
description of source to destination mapping

Description

This routine checks that the dimensions of the submatrix are compatible with the destination matrix, that the dimensional extents are consistent with the source and destination matrices, and that the offsets are consistent. It can deal with non-expanded map entries.

Returns

It returns zero if the request is legal, non-zero otherwise.