curlcpp

An object-oriented C++ wrapper for cURL tool

If you want to know a bit more about cURL, you should go on the official website and read about the three interfaces that curl implements: http://curl.haxx.se/

Compile and link

Standalone

cd build
cmake ..
make # -j2

Then add <curlcpp root>/build/src/ to your library path and <curlcpp root>/include/ to your include path.

When linking, link against curlcpp (e.g.: gcc -std=c++11 example.cpp -o example -lcurlcpp).

Submodule

When using a git submodule and CMake-buildsystem, add the following lines to your CMakeLists.txt:

ADD_SUBDIRECTORY(ext/curlcpp) # Change `ext/curlcpp` to a directory according to your setup
INCLUDE_DIRECTORIES(${CURLCPP_SOURCE_DIR}/include)

Simple usage example

Here's an example of a simple HTTP request to get google web page, using the curl_easy interface:

#include <iostream>
#include "../include/CurlEasy.h"
// only "CurlEasy.h" if you use above submodule-way of compilation and linking

using std::cout;
using std::endl;
using curl::CurlEasy;

int main(int argc, const char **argv) {
    CurlEasy easy;
    easy.add(CurlPair<CURLoption,string>(CURLOPT_URL,"http://www.google.it") );
    easy.add(CurlPair<CURLoption,long>(CURLOPT_FOLLOWLOCATION,1L));
    try {
        easy.perform();
    } catch (CurlError error) {
        // If you want to get the entire error stack we can do:
        stack<pair<string,string>> errors = error.what();
        // Otherwise we could print the stack like this:
        error.printTraceback();
        // Note that the printing the stack will erase it
    }
    return 0;
}

Here's instead, the creation of an HTTPS POST login form:

#include <iostream>
#include "CurlEasy.h"
#include "CurlHttpPost.h"
// only "CurlEasy.h" and "CurlHttpPost.h" if you use above submodule-way of compilation and linking

using std::cout;
using std::endl;
using curl::CurlEasy;
using curl::CurlHttpPost;

int main(int argc, const char * argv[]) {
    CurlEasy easy;
    CurlHttpPost post;
    // Imagine these two lines like two html forms!
    post.add(CurlPair<CURLformoption,string>(CURLFORM_COPYNAME,"user"),CurlPair<CURLformoption,string>(CURLFORM_COPYCONTENTS,"username")); 
    post.add(CurlPair<CURLformoption,string>(CURLFORM_COPYNAME,"passw"), CurlPair<CURLformoption,string>(CURLFORM_COPYCONTENTS,"password"));
                 
    easy.add(CurlPair<CURLoption,string>(CURLOPT_URL,"https://xxxxx/"));
    easy.add(CurlPair<CURLoption,CurlHttpPost>(CURLOPT_HTTPPOST,post));

    try {
        easy.perform();
    } catch (CurlError error) {
        // If you want to get the entire error stack we can do:
        stack<pair<string,string>> errors = error.what();
        // Otherwise we could print the stack like this:
        error.printTraceback();
        // Note that the printing the stack will erase it
    }
    return 0;
}

That's it! :)