Next: , Previous: bpipe_offset_new, Up: Utility Functions


A.4.19 bpipe_offset_new_va

Allocate an offset array.

Synopsis

     #include <bpipe/bpipe.h>
     
     
     
size_t *bpipe_offset_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

Offset 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 was less than 1 or one of the offsets was negative
BPENOMEM
a memory allocation failed