You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
26 lines
772 B
Groff
26 lines
772 B
Groff
16 years ago
|
.TH iarray_get 3
|
||
|
|
.SH NAME
|
||
|
|
iarray_get \- get pointer to nth element in iarray
|
||
|
|
.SH SYNTAX
|
||
|
|
.B #include <iarray.h>
|
||
|
|
|
||
|
|
void* \fBiarray_get\fP(iarray* \fIx\fR, size_t \fIpos\fR);
|
||
|
|
|
||
|
|
iarray \fIx\fR;
|
||
|
|
size_t \fIpos\fR;
|
||
|
|
\fIt\fR* p = iarray_get(&\fIx\fR,\fIpos\fR);
|
||
|
|
|
||
|
|
.SH DESCRIPTION
|
||
|
|
iarray_get is similar to iarray_allocate, but it only works if the
|
||
|
|
element has previously been allocated. If the element in the iarray
|
||
|
|
is not there, this function will fail instead of manipulating the
|
||
|
|
iarray. This also guarantees that there will be no locks, so this
|
||
|
|
function returns in a deterministic time.
|
||
|
|
|
||
|
|
.SH "RETURN VALUE"
|
||
|
|
Return a pointer to the requested element. If there is no such element
|
||
|
|
in the array, returns NULL.
|
||
|
|
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
iarray_init(3), iarray_allocate(3), iarray_free(3)
|