Next: bpipe_matrix_squeeze, Previous: bpipe_matrix_new, Up: Utility Functions
create a binary pipe matrix specification
#include <bpipe/bpipe.h>BPMatrix *bpipe_matrix_new_va( size_t nd, ... );
size_t nd
- the number of dimensions in the matrix
...
- the extents of the dimensions. there must be as many extents as there are dimensions
This routine creates a binary pipe matrix specification of a given dimensionality. It allocates memory for the matrix structure and its associated data. To ease filling in the associated extents array, the extents are passed as a variable argument list.
Upon successful completion a pointer to the new matrix is returned.
Upon error bpipe_errno
is set and NULL
is returned.
Upon error bpipe_errno
is set to one of the following errors:
BPEBADARG
BPENOMEM