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.
20 lines
733 B
Groff
20 lines
733 B
Groff
16 years ago
|
.TH buffer_tosa 3
|
||
|
|
.SH NAME
|
||
|
|
buffer_tosa \- initialize buffer for writing to stralloc
|
||
|
|
.SH SYNTAX
|
||
|
|
.B #include <buffer.h>
|
||
|
|
|
||
|
|
int \fBbuffer_tosa\fR(buffer* \fIb\fR,stralloc* \fIsa\fR);
|
||
|
|
.SH DESCRIPTION
|
||
|
|
buffer_tosa makes a virtual write buffer from a stralloc. The buffer
|
||
|
|
writing functions will append data to the stralloc until the stralloc
|
||
|
|
fails to allocate more memory. You still need to flush the buffer.
|
||
|
|
|
||
|
|
Note that in the end the stralloc will have allocated more memory than
|
||
|
|
is needed to hold the actual contents. The waste is 1024 bytes.
|
||
|
|
.SH "RETURN VALUE"
|
||
|
|
buffer_tosa returns 0 if everything was fine, -1 if it failed to
|
||
|
|
allocate space for the initial data in the stralloc.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
buffer_tosa(3), buffer_init(3), buffer(3)
|