GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LIBOWFAT_BUFFER_GET_TOKEN_SA (3)

NAME

buffer_get_token_sa - read token from buffer

CONTENTS

Syntax
Description
Rationale

SYNTAX


#include <stralloc.h> 

#include <buffer.h> 

int buffer_get_token_sa(buffer* b,stralloc* sa, const char* charset,size_t setlen);

DESCRIPTION

buffer_get_token_sa appends data from the b to sa until one of the delimiters in charset is found, NOT overwriting the previous content of sa. That delimiter is also appended to sa.

If reading from the buffer or allocating memory fails, buffer_get_token_sa returns -1 and sets errno appropriately. At that point sa may already contain a partial token.

RETURN VALUE

-1 on error (setting errno), 0 on EOF, 1 when successful.

RATIONALE

buffer_get_token_sa appends instead of overwriting so it can be used on non-blocking sockets (these signal error and set errno to EAGAIN; in this case you can simply call buffer_get_token_sa again when select or poll indicate more data is available).

SEE ALSO

buffer_getline_sa(3), buffer_get_token(3), buffer(3)
Search for    or go to Top of page |  Section 3 |  Main Index


BUFFER_GET_TOKEN_SA (3) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.