Next: , Previous: bpipe_memfill, Up: Utility Functions


A.4.18 bpipe_offset_new

Allocate an offset array.

Synopsis

     #include <bpipe/bpipe.h>
     
     
     
size_t *bpipe_offset_new( size_t nd, size_t init );

Parameters

size_t nd
the number of dimensions
size_t init
the value to initialize the offsets to

Description

Offset arrays are required by various bpipe support routines. This routine makes it easy to allocate one. It creates an offset array with all offsets set to a passed value.

Returns

It returns a pointer to an array of integers, filled in with the specified value. 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
BPENOMEM
a memory allocation failed