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.
27 lines
909 B
Groff
27 lines
909 B
Groff
20 years ago
|
.TH buffer_get_new_token_sa 3
|
||
|
|
.SH NAME
|
||
|
|
buffer_get_new_token_sa \- read token from buffer
|
||
|
|
.SH SYNTAX
|
||
|
|
.nf
|
||
|
|
.B #include <stralloc.h>
|
||
|
|
.B #include <buffer.h>
|
||
|
|
|
||
|
|
int \fBbuffer_get_new_token_sa\fP(buffer* \fIb\fR,stralloc* \fIsa\fR,
|
||
|
|
const char* \fIcharset\fR,unsigned int \fIsetlen\fR);
|
||
|
|
.SH DESCRIPTION
|
||
|
|
buffer_get_new_token_sa copies data from the \fIb\fR to \fIsa\fR until
|
||
|
|
one of the delimiters in \fIcharset\fR is found, overwriting the
|
||
|
|
previous content of \fIsa\fR. That delimiter is also copied to
|
||
|
|
\fIsa\fR.
|
||
|
|
|
||
|
|
If reading from the buffer or allocating memory fails,
|
||
|
|
buffer_get_new_token_sa returns -1 and sets \fIerrno\fR appropriately. At
|
||
|
|
that point \fIsa\fR may already contain a partial token.
|
||
|
|
|
||
|
|
On success, buffer_get_new_token_sa returns 0.
|
||
|
|
|
||
|
|
If you want to read from a non-blocking socket, use buffer_get_token_sa
|
||
|
|
instead.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
buffer_getline_sa(3), buffer_get_token(3), buffer(3)
|