Main MRPT website > C++ reference
MRPT logo
Enumerations | Functions

mrpt::utils::net Namespace Reference


Detailed Description

A set of useful routines for networking.

Enumerations

enum  ERRORCODE_HTTP {
  erOk = 0, erBadURL, erCouldntConnect, erNotFound,
  erOtherHTTPError
}
 

Possible returns from a HTTP request.

More...

Functions

ERRORCODE_HTTP BASE_IMPEXP http_get (const string &url, vector_byte &out_content, string &out_errormsg, int port=80, const string &auth_user=string(), const string &auth_pass=string(), int *out_http_responsecode=NULL, mrpt::utils::TParameters< string > *extra_headers=NULL, mrpt::utils::TParameters< string > *out_headers=NULL, int timeout_ms=1000)
 Perform an HTTP GET operation (version for retrieving the data as a vector_byte)
ERRORCODE_HTTP BASE_IMPEXP http_get (const string &url, string &out_content, string &out_errormsg, int port=80, const string &auth_user=string(), const string &auth_pass=string(), int *out_http_responsecode=NULL, mrpt::utils::TParameters< string > *extra_headers=NULL, mrpt::utils::TParameters< string > *out_headers=NULL, int timeout_ms=1000)
 Perform an HTTP GET operation (version for retrieving the data as text)
bool DNS_resolve_async (const std::string &server_name, std::string &out_ip, const unsigned int timeout_ms=3000)
 Resolve a server address by its name, returning its IP address as a string - This method has a timeout for the maximum time to wait for the DNS server.

Enumeration Type Documentation

Possible returns from a HTTP request.

Enumerator:
erOk 
erBadURL 
erCouldntConnect 
erNotFound 
erOtherHTTPError 

Definition at line 46 of file net_utils.h.


Function Documentation

bool mrpt::utils::net::DNS_resolve_async ( const std::string &  server_name,
std::string &  out_ip,
const unsigned int  timeout_ms = 3000 
)

Resolve a server address by its name, returning its IP address as a string - This method has a timeout for the maximum time to wait for the DNS server.

For example: server_name="www.google.com" -> out_ip="209.85.227.99"

Returns:
true on success, false on timeout or other error.
ERRORCODE_HTTP BASE_IMPEXP mrpt::utils::net::http_get ( const string &  url,
vector_byte &  out_content,
string &  out_errormsg,
int  port = 80,
const string &  auth_user = string(),
const string &  auth_pass = string(),
int *  out_http_responsecode = NULL,
mrpt::utils::TParameters< string > *  extra_headers = NULL,
mrpt::utils::TParameters< string > *  out_headers = NULL,
int  timeout_ms = 1000 
)

Perform an HTTP GET operation (version for retrieving the data as a vector_byte)

Parameters:
urlMust be a simple string of the form "http://<servername>/<relative-address>".
portThe server port, if different from 80.
extra_headersIf provided, the given extra HTTP headers will be sent.
out_errormsgOn exit will contain a description of the error or "Ok".
out_contentThe buffer with the retrieved data.
out_http_responsecodeIf provided, will hold the HTTP code, eg: 200, 404...
out_headersIf provided, a copy of all the headers returned by the server will be saved here.
auth_userSend a basic HTTP authorization request with the given user & password.
auth_passSend a basic HTTP authorization request with the given user & password.
Returns:
The error or success code.
See also:
mrpt::utils::vectorToBinaryFile
ERRORCODE_HTTP BASE_IMPEXP mrpt::utils::net::http_get ( const string &  url,
string &  out_content,
string &  out_errormsg,
int  port = 80,
const string &  auth_user = string(),
const string &  auth_pass = string(),
int *  out_http_responsecode = NULL,
mrpt::utils::TParameters< string > *  extra_headers = NULL,
mrpt::utils::TParameters< string > *  out_headers = NULL,
int  timeout_ms = 1000 
)

Perform an HTTP GET operation (version for retrieving the data as text)

Parameters:
urlMust be a simple string of the form "http://<servername>/<relative-address>".
portThe server port, if different from 80.
extra_headersIf provided, the given extra HTTP headers will be sent.
out_errormsgOn exit will contain a description of the error or "Ok".
out_contentThe buffer with the retrieved data.
out_http_responsecodeIf provided, will hold the HTTP code, eg: 200, 404...
out_headersIf provided, a copy of all the headers returned by the server will be saved here.
auth_userSend a basic HTTP authorization request with the given user & password.
auth_passSend a basic HTTP authorization request with the given user & password.
Returns:
The error or success code.
See also:
mrpt::utils::vectorToBinaryFile



Page generated by Doxygen 1.7.3 for MRPT 0.9.4 SVN:exported at Tue Jan 25 21:56:31 UTC 2011