• Main Page
• Topics
• Namespaces
• Classes
• Files
•  

• Class List
• Class Index
• Class Hierarchy
• Class Members

Loading...

Searching...

No Matches

• sf
• Http
• Request

Public Types | Public Member Functions | Friends | List of all members

sf::Http::Request Class Reference

HTTP request. More...

#include <SFML/Network/Http.hpp>

Public Types
enum class	Method {   Get , Post , Head , Put ,   Delete }
	Enumerate the available HTTP methods for a request. More...

Public Member Functions
	Request (const std::string &uri="/", Method method=Method::Get, const std::string &body="")
	Default constructor.
void	setField (const std::string &field, const std::string &value)
	Set the value of a field.
void	setMethod (Method method)
	Set the request method.
void	setUri (const std::string &uri)
	Set the requested URI.
void	setHttpVersion (unsigned int major, unsigned int minor)
	Set the HTTP version for the request.
void	setBody (const std::string &body)
	Set the body of the request.

Friends
class	Http

Detailed Description

HTTP request.

Definition at line 56 of file Http.hpp.

Member Enumeration Documentation

◆ Method

enum class sf::Http::Request::Method

strong

Enumerate the available HTTP methods for a request.

Enumerator
Get	Request in get mode, standard method to retrieve a page.
Post	Request in post mode, usually to send data to a page.
Head	Request a page's header only.
Put	Request in put mode, useful for a REST API.
Delete	Request in delete mode, useful for a REST API.

Definition at line 63 of file Http.hpp.

Constructor & Destructor Documentation

◆ Request()

sf::Http::Request::Request	(	const std::string &	uri = "/",
		Method	method = Method::Get,
		const std::string &	body = "" )

Default constructor.

This constructor creates a GET request, with the root URI ("/") and an empty body.

Parameters

uri	Target URI
method	Method to use for the request
body	Content of the request's body

Member Function Documentation

◆ setBody()

void sf::Http::Request::setBody

(

const std::string &

body

)

Set the body of the request.

The body of a request is optional and only makes sense for POST requests. It is ignored for all other methods. The body is empty by default.

Parameters

body	Content of the body

◆ setField()

void sf::Http::Request::setField	(	const std::string &	field,
		const std::string &	value )

Set the value of a field.

The field is created if it doesn't exist. The name of the field is case-insensitive. By default, a request doesn't contain any field (but the mandatory fields are added later by the HTTP client when sending the request).

Parameters

field	Name of the field to set
value	Value of the field

◆ setHttpVersion()

void sf::Http::Request::setHttpVersion	(	unsigned int	major,
		unsigned int	minor )

Set the HTTP version for the request.

The HTTP version is 1.0 by default.

Parameters

major	Major HTTP version number
minor	Minor HTTP version number

◆ setMethod()

void sf::Http::Request::setMethod

(

Method

method

)

Set the request method.

See the Method enumeration for a complete list of all the available methods. The method is Http::Request::Method::Get by default.

Parameters

method

Method to use for the request

◆ setUri()

void sf::Http::Request::setUri

(

const std::string &

uri

)

Set the requested URI.

The URI is the resource (usually a web page or a file) that you want to get or post. The URI is "/" (the root page) by default.

Parameters

uri	URI to request, relative to the host

Friends And Related Symbol Documentation

◆ Http

friend class Http

friend

Definition at line 148 of file Http.hpp.

---

The documentation for this class was generated from the following file:

• Http.hpp