Next: , Previous: bpipe_matrix_dup, Up: Utility Functions   [Contents]


A.4.12 bpipe_matrix_min

create a binary pipe matrix with the minimum number of dimensions and extent from a pair of binary pipe matrix.

Synopsis

#include <bpipe/bpipe.h>

BPMatrix *bpipe_matrix_min(
  BPMatrix *a,
  BPMatrix *b
);

Parameters

BPMatrix *a

Not Documented.

BPMatrix *b

Not Documented.

Description

This routine creates a binary pipe matrix which has the minimum number of dimensions and extent from a pair of binary pipe matrix argument. It allocates memory for the matrix structure and its associated data.

Returns

Upon successful completion a pointer to the new matrix is returned. Upon error bpipe_errno is set and NULL is returned.

Errors

Upon error bpipe_errno is set to one of the following errors:

BPEBADARG

the passed argument is bogus or the matrix specification was illegal

BPENOMEM

a memory allocation failed