CSFML - C binding of the Simple and Fast Multimedia Library

CSFML

- Main Page
- Data Structures
- Files

- File List
- Globals

Http.h
Go to the documentation of this file.
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2015 Laurent Gomila (laurent@sfml-dev.org)
5 //
6 // This software is provided 'as-is', without any express or implied warranty.
7 // In no event will the authors be held liable for any damages arising from the use of this software.
8 //
9 // Permission is granted to anyone to use this software for any purpose,
10 // including commercial applications, and to alter it and redistribute it freely,
11 // subject to the following restrictions:
12 //
13 // 1. The origin of this software must not be misrepresented;
14 // you must not claim that you wrote the original software.
15 // If you use this software in a product, an acknowledgment
16 // in the product documentation would be appreciated but is not required.
17 //
18 // 2. Altered source versions must be plainly marked as such,
19 // and must not be misrepresented as being the original software.
20 //
21 // 3. This notice may not be removed or altered from any source distribution.
22 //
24
25 #ifndef SFML_HTTP_H
26 #define SFML_HTTP_H
27
29 // Headers
31 #include <SFML/Network/Export.h>
32 #include <SFML/Network/Types.h>
33 #include <SFML/System/Time.h>
34
35
40 typedef enum
41 {
42 sfHttpGet,
43 sfHttpPost,
44 sfHttpHead,
45 sfHttpPut,
46 sfHttpDelete
47 } sfHttpMethod;
48
49
54 typedef enum
55 {
56 // 2xx: success
57 sfHttpOk = 200,
58 sfHttpCreated = 201,
59 sfHttpAccepted = 202,
60 sfHttpNoContent = 204,
61 sfHttpResetContent = 205,
62 sfHttpPartialContent = 206,
63
64 // 3xx: redirection
65 sfHttpMultipleChoices = 300,
66 sfHttpMovedPermanently = 301,
67 sfHttpMovedTemporarily = 302,
68 sfHttpNotModified = 304,
69
70 // 4xx: client error
71 sfHttpBadRequest = 400,
72 sfHttpUnauthorized = 401,
73 sfHttpForbidden = 403,
74 sfHttpNotFound = 404,
75 sfHttpRangeNotSatisfiable = 407,
76
77 // 5xx: server error
78 sfHttpInternalServerError = 500,
79 sfHttpNotImplemented = 501,
80 sfHttpBadGateway = 502,
81 sfHttpServiceNotAvailable = 503,
82 sfHttpGatewayTimeout = 504,
83 sfHttpVersionNotSupported = 505,
84
85 // 10xx: SFML custom codes
86 sfHttpInvalidResponse = 1000,
87 sfHttpConnectionFailed = 1001
88 } sfHttpStatus;
89
90
97 CSFML_NETWORK_API sfHttpRequest* sfHttpRequest_create(void);
98
105 CSFML_NETWORK_API void sfHttpRequest_destroy(sfHttpRequest* httpRequest);
106
121 CSFML_NETWORK_API void sfHttpRequest_setField(sfHttpRequest* httpRequest, const char* field, const char* value);
122
134 CSFML_NETWORK_API void sfHttpRequest_setMethod(sfHttpRequest* httpRequest, sfHttpMethod method);
135
147 CSFML_NETWORK_API void sfHttpRequest_setUri(sfHttpRequest* httpRequest, const char* uri);
148
159 CSFML_NETWORK_API void sfHttpRequest_setHttpVersion(sfHttpRequest* httpRequest, unsigned int major, unsigned int minor);
160
172 CSFML_NETWORK_API void sfHttpRequest_setBody(sfHttpRequest* httpRequest, const char* body);
173
180 CSFML_NETWORK_API void sfHttpResponse_destroy(sfHttpResponse* httpResponse);
181
195 CSFML_NETWORK_API const char* sfHttpResponse_getField(const sfHttpResponse* httpResponse, const char* field);
196
210 CSFML_NETWORK_API sfHttpStatus sfHttpResponse_getStatus(const sfHttpResponse* httpResponse);
211
220 CSFML_NETWORK_API unsigned int sfHttpResponse_getMajorVersion(const sfHttpResponse* httpResponse);
221
230 CSFML_NETWORK_API unsigned int sfHttpResponse_getMinorVersion(const sfHttpResponse* httpResponse);
231
246 CSFML_NETWORK_API const char* sfHttpResponse_getBody(const sfHttpResponse* httpResponse);
247
254 CSFML_NETWORK_API sfHttp* sfHttp_create(void);
255
262 CSFML_NETWORK_API void sfHttp_destroy(sfHttp* http);
263
280 CSFML_NETWORK_API void sfHttp_setHost(sfHttp* http, const char* host, unsigned short port);
281
301 CSFML_NETWORK_API sfHttpResponse* sfHttp_sendRequest(sfHttp* http, const sfHttpRequest* request, sfTime timeout);
302
303
304 #endif // SFML_HTTP_H
sfHttpMovedPermanently
The requested page has permanently moved to a new location.
Definition: Http.h:66
Types.h
sfHttpMovedTemporarily
The requested page has temporarily moved to a new location.
Definition: Http.h:67
sfHttp_destroy
CSFML_NETWORK_API void sfHttp_destroy(sfHttp *http)
Destroy a Http object.
sfHttpServiceNotAvailable
The server is temporarily unavailable (overloaded, in maintenance, ...)
Definition: Http.h:81
sfHttpGatewayTimeout
The gateway server couldn't receive a response from the source server.
Definition: Http.h:82
CSFML_NETWORK_API
#define CSFML_NETWORK_API
Definition: Network/Export.h:43
sfHttpNotFound
The requested page doesn't exist.
Definition: Http.h:74
sfHttpGet
Request in get mode, standard method to retrieve a page.
Definition: Http.h:42
sfHttpRequest_setField
CSFML_NETWORK_API void sfHttpRequest_setField(sfHttpRequest *httpRequest, const char *field, const char *value)
Set the value of a header field of a HTTP request.
sfHttpBadGateway
The gateway server has received an error from the source server.
Definition: Http.h:80
sfHttpMethod
sfHttpMethod
Enumerate the available HTTP methods for a request.
Definition: Http.h:40
sfHttpPartialContent
The server has sent a part of the resource, as a response to a partial GET request.
Definition: Http.h:62
sfHttpRequest_setMethod
CSFML_NETWORK_API void sfHttpRequest_setMethod(sfHttpRequest *httpRequest, sfHttpMethod method)
Set a HTTP request method.
sfHttpResponse_getMinorVersion
CSFML_NETWORK_API unsigned int sfHttpResponse_getMinorVersion(const sfHttpResponse *httpResponse)
Get the minor HTTP version number of a HTTP response.
sfHttpRequest_create
CSFML_NETWORK_API sfHttpRequest * sfHttpRequest_create(void)
Create a new HTTP request.
sfHttpRequest
struct sfHttpRequest sfHttpRequest
Definition: Network/Types.h:33
sfHttpRequest_setHttpVersion
CSFML_NETWORK_API void sfHttpRequest_setHttpVersion(sfHttpRequest *httpRequest, unsigned int major, unsigned int minor)
Set the HTTP version of a HTTP request.
sfHttpInvalidResponse
Response is not a valid HTTP one.
Definition: Http.h:86
sfHttpResponse_getBody
CSFML_NETWORK_API const char * sfHttpResponse_getBody(const sfHttpResponse *httpResponse)
Get the body of a HTTP response.
sfHttpNotModified
For conditional requests, means the requested page hasn't changed and doesn't need to be refreshed...
Definition: Http.h:68
sfHttpVersionNotSupported
The server doesn't support the requested HTTP version.
Definition: Http.h:83
sfHttpResetContent
The server informs the client that it should clear the view (form) that caused the request to be sent...
Definition: Http.h:61
sfHttpOk
Most common code returned when operation was successful.
Definition: Http.h:57
sfHttpAccepted
The request has been accepted, but will be processed later by the server.
Definition: Http.h:59
sfHttpResponse_destroy
CSFML_NETWORK_API void sfHttpResponse_destroy(sfHttpResponse *httpResponse)
Destroy a HTTP response.
sfHttpResponse_getMajorVersion
CSFML_NETWORK_API unsigned int sfHttpResponse_getMajorVersion(const sfHttpResponse *httpResponse)
Get the major HTTP version number of a HTTP response.
sfHttpForbidden
The requested page cannot be accessed at all, even with authentication.
Definition: Http.h:73
sfHttpResponse_getStatus
CSFML_NETWORK_API sfHttpStatus sfHttpResponse_getStatus(const sfHttpResponse *httpResponse)
Get the status code of a HTTP reponse.
sfTime
Represents a time value.
Definition: Time.h:38
sfHttpMultipleChoices
The requested page can be accessed from several locations.
Definition: Http.h:65
sfHttpResponse
struct sfHttpResponse sfHttpResponse
Definition: Network/Types.h:34
sfHttpBadRequest
The server couldn't understand the request (syntax error)
Definition: Http.h:71
sfHttpNoContent
Sent when the server didn't send any data in return.
Definition: Http.h:60
sfHttpPost
Request in post mode, usually to send data to a page.
Definition: Http.h:43
sfHttpNotImplemented
The server doesn't implement a requested feature.
Definition: Http.h:79
sfHttp_sendRequest
CSFML_NETWORK_API sfHttpResponse * sfHttp_sendRequest(sfHttp *http, const sfHttpRequest *request, sfTime timeout)
Send a HTTP request and return the server's response.
sfHttpHead
Request a page's header only.
Definition: Http.h:44
sfHttpConnectionFailed
Connection with server failed.
Definition: Http.h:87
sfHttpRequest_setBody
CSFML_NETWORK_API void sfHttpRequest_setBody(sfHttpRequest *httpRequest, const char *body)
Set the body of a HTTP request.
sfHttp_create
CSFML_NETWORK_API sfHttp * sfHttp_create(void)
Create a new Http object.
sfHttpRangeNotSatisfiable
The server can't satisfy the partial GET request (with a "Range" header field)
Definition: Http.h:75
sfHttp_setHost
CSFML_NETWORK_API void sfHttp_setHost(sfHttp *http, const char *host, unsigned short port)
Set the target host of a HTTP object.
sfHttpUnauthorized
The requested page needs an authentication to be accessed.
Definition: Http.h:72
sfHttpDelete
Request in delete mode, useful for a REST API.
Definition: Http.h:46
sfHttpRequest_setUri
CSFML_NETWORK_API void sfHttpRequest_setUri(sfHttpRequest *httpRequest, const char *uri)
Set a HTTP request URI.
sfHttpRequest_destroy
CSFML_NETWORK_API void sfHttpRequest_destroy(sfHttpRequest *httpRequest)
Destroy a HTTP request.
sfHttpPut
Request in put mode, useful for a REST API.
Definition: Http.h:45
sfHttpResponse_getField
CSFML_NETWORK_API const char * sfHttpResponse_getField(const sfHttpResponse *httpResponse, const char *field)
Get the value of a field of a HTTP response.
Export.h
Time.h
sfHttpCreated
The resource has successfully been created.
Definition: Http.h:58
sfHttpStatus
sfHttpStatus
Enumerate all the valid status codes for a response.
Definition: Http.h:54
sfHttpInternalServerError
The server encountered an unexpected error.
Definition: Http.h:78
sfHttp
struct sfHttp sfHttp
Definition: Network/Types.h:35