2003-09-01 17:59:12 +00:00
|
|
|
.TH array_length 3
|
|
|
|
|
.SH NAME
|
|
|
|
|
array_length \- get number of allocated members in array
|
|
|
|
|
.SH SYNTAX
|
2017-05-13 22:51:26 +00:00
|
|
|
.B #include <libowfat/array.h>
|
2003-09-01 17:59:12 +00:00
|
|
|
|
|
|
|
|
int64 \fBarray_length\fP(array* \fIx\fR,uint64 \fImembersize\fR);
|
|
|
|
|
|
|
|
|
|
array \fIx\fR;
|
|
|
|
|
int64 members = array_length(&\fIx\fR,sizeof(\fIt\fR));
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
array_length returns the number of initialized bytes in \fIx\fR, divided
|
|
|
|
|
by the size of \fIt\fR. In other words, array_get will succeed for
|
|
|
|
|
positions 0 through array_length-1; it will fail for position
|
|
|
|
|
array_length.
|
|
|
|
|
|
|
|
|
|
If \fIx\fR is unallocated, array_length and array_bytes return 0.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
array_allocate(3), array_get(3), array_fail(3), array_bytes(3)
|
