GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LIBOWFAT_IARRAY_ALLOCATE (3)

NAME

iarray_allocate - get pointer to nth element in iarray

CONTENTS

Syntax
Description

SYNTAX

#include <iarray.h>

void* iarray_allocate(iarray* x, size_t pos);

iarray x;
size_t pos;
t* p = iarray_allocate(&x,pos);

DESCRIPTION

iarray_allocate is similar to iarray_get, but if the requested element is not in the array, the array will be resized. If the resize fails, iarray_allocate returns NULL and leaves the array untouched.

This function is safe to use in environments with multiple threads, but it can block for indeterminate time if other threads are reallocating the array at the same time.

Note that it is safe to use iarray_allocate where you would otherwise use iarray_get. The only reason to use iarray_get over iarray_allocate would be optimization.

RETURN VALUE

Return a pointer to the requested element. If there was a memory allocation failure, returns NULL.

SEE ALSO

iarray_init(3), iarray_get(3), iarray_free(3)
Search for    or go to Top of page |  Section 3 |  Main Index


IARRAY_ALLOCATE (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.