Next: , Previous: bpipe_extent_new, Up: Utility Functions


A.4.8 bpipe_extent_new_va

allocate an extent array

Synopsis

     #include <bpipe/bpipe.h>
     
     
     
void *bpipe_extent_new_va( size_t nd, ... );

Parameters

size_t nd
the number of dimensions
...
the integer values of the extents. there must be nd values, and should be of type int

Description

Extent arrays are required by various bpipe support routines. This routine makes it easy to allocate one and fill it in.

Returns

It returns a pointer to an array of integers, filled in with the specified values. 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 number of dimensions or one of the extents was less than 1
BPENOMEM
a memory allocation failed