http_fetch.3

指定 一个 合法 的 URL

.TH "HTTP Fetcher" "3" "June 26, 2001" "Lyle Hanson" "HTTP Fetcher API"
.SH "NAME"
.LP 
\fBhttp_fetch\fR \- Downloads a file via HTTP.
.SH "SYNOPSIS"
.LP 
\fB#include <http_fetcher.h>\fR
.br 
.LP 
\fBint http_fetch(const char *\fR\fIurl\fR\fB, char **\fR\fIfileBuf\fR);
.br 
.SH "DESCRIPTION"
.LP 
Download the file located at \fIurl\fR.  Memory is allocated to hold the file, and is pointed to by \fIfileBuf\fR.

If you pass \fBNULL\fR for \fIfileBuf\fR, \fIurl\fR will be requested but will not remain in memory (useful for simply registering a hit).
.SH "RETURN VALUE"
.LP 
On success, \fBhttp_fetch\fR returns the number of bytes of data downloaded (HTTP metadata not included).

On error, \-1 is returned, and \fBhttp_perror\fR can be used to print an informative error message.  \fBhttp_strerror\fR can be used to get a pointer to the current error description message.
.SH "SEE ALSO"
.LP 
\fBhttp_setUserAgent\fR(3), \fBhttp_setReferer\fR(3),
.br 
\fBhttp_setTimeout\fR(3), \fBhttp_parseFilename\fR(3), \fBhttp_perror\fR(3), \fBhttp_strerror\fR(3)