### Navigation

- next
- previous |
- cpp-netlib v0.11.1 »

Straightforward network programming in modern C++

# Getting cpp-netlib

You can find out more about the `cpp-netlib` project at http://cpp-netlib.org/.

Download

You can get the latest official version of the library from the official project website at:

> http://cpp-netlib.org/

This version of `cpp-netlib` is tagged as cpp-netlib-0.11.0 in the GitHub repository. You can find more information about the progress of the development by checking our GitHub project page at:

> http://github.com/cpp-netlib/cpp-netlib

Support

You can ask questions, join the discussion, and report issues to the developers mailing list by joining via:

> https://groups.google.com/group/cpp-netlib

You can also file issues on the Github issue tracker at:

> http://github.com/cpp-netlib/cpp-netlib/issues

We are a growing community and we are happy to accept new contributions and ideas.

# C++ Network Library

`cpp-netlib` is a library collection that provides application layer protocol support using modern C++ techniques. It is light-weight, fast, portable and is intended to be as easy to configure as possible.

# Hello, world!

The `cpp-netlib` allows developers to write fast, portable network applications with the minimum of fuss.

An HTTP server-client example can be written in tens of lines of code. The client is as simple as this:

    using namespace boost::network;
    using namespace boost::network::http;

    client::request request_("http://127.0.0.1:8000/");
    request_ << header("Connection", "close");
    client client_;
    client::response response_ = client_.get(request_);
    std::string body_ = body(response_);

And the corresponding server code is listed below:

    namespace http = boost::network::http;

    struct handler;
    typedef http::server<handler> http_server;

    struct handler {
        void operator() (http_server::request const &request,
                         http_server::response &response) {
            response = http_server::response::stock_reply(
                http_server::response::ok, "Hello, world!");
        }

        void log(http_server::string_type const &info) {
            std::cerr << "ERROR: " << info << '\n';
        }
    };

    int main(int arg, char * argv[]) {
        handler handler_;
        http_server::options options(handler_);
        http_server server_(
            options.address("0.0.0.0")
                   .port("8000"));
        server_.run();
    }

# Want to learn more?

> - Take a look at the getting started guide
> - Learn from some simple examples
> - Find out what’s new
> - Study the library in more depth
> - Discover more through the full reference
> - Full table of contents

Warning

Be aware that not all features are stable. The generic message design is under review and the URI and HTTP client implementation will continue to undergo refactoring. Future versions will include support for other network protocols.

### Navigation

- next
- previous |
- cpp-netlib v0.11.1 »