.. :Authors: Glyn Matthews glyn.matthews@gmail.com .. :Date: Jan 01, 2013 .. :Description: Source code for the cpp-netlib URI class.

################### Deprecation warning ###################

This library is still missing some features (including full Unicode support), and does not work on some of the newest compiler versions. Therefore, please prefer to use the WhatWG URL implementation_ that is intended to supersede this library.

.. _WhatWG URL implementation: https://github.com/cpp-netlib/url

################ C++ Network URI ################

.. image:: https://travis-ci.org/cpp-netlib/uri.png?branch=master :target: https://travis-ci.org/cpp-netlib/uri

.. image:: https://ci.appveyor.com/api/projects/status/rjt0nbbtdhsjdjv4?svg=true :target: https://ci.appveyor.com/project/glynos/uri-6fkuc

.. image:: https://img.shields.io/badge/license-boost-blue.svg :target: https://github.com/cpp-netlib/uri/blob/master/LICENSE_1_0.txt

This project contains the source code that was originally meant to track the proposal for a C++ URI at http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2014/n3975.html

This package provides:

* A ``network::uri`` class that implements a generic URI parser,
  compatible with `RFC 3986`_ and `RFC 3987`_
* Accessors to the underlying URI parts
* A range-compatible interface
* Methods to normalize and compare URIs
* Percent encoding and decoding functions
* A URI builder to build consistent URIs from parts, including
  case, percent encoding and path normalization

.. _RFC 3986: http://tools.ietf.org/html/rfc3986 .. _RFC 3987: http://tools.ietf.org/html/rfc3987

Building the project

Building with CMake

::

$ mkdir _build
$ cd _build
$ cmake ..
$ make -j4

Running the tests with CTest

::

$ ctest

License

This library is released under the Boost Software License (please see http://boost.org/LICENSE_1_0.txt or the accompanying LICENSE_1_0.txt file for the full text.

Contact

Any questions about this library can be addressed to the cpp-netlib developers mailing list_. Issues can be filed using Github at http://github.com/cpp-netlib/uri/issues.

.. _developers mailing list: cpp-netlib@googlegroups.com