array_truncate - Man Page

reduce number of initialized bytes

Syntax

#include <array.h>

void array_truncate(array* x, uint64 membersize, int64 len);

 array_truncate(&x,sizeof(t),len);

Description

array_truncate reduces the number of initialized bytes in x to exactly len*sizeof(t). If the number of initialized bytes was already this small (or smaller), array_truncate has no effect. If len is negative, array_truncate has no effect. If x is unallocated, array_truncate has no effect. If x has failed, array_truncate has no effect.

array_truncate does not change the allocation in x. If you want to free the memory used by x, use array_reset.

See Also

array_allocate(3), array_get(3), array_fail(3), array_trunc(3), array_reset(3)

Referenced By

array_reset(3), array_trunc(3).