Boost C++ Libraries of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for a snapshot of the master branch, built from commit 5002c2d6a2.


For a wide range of applications the library's container interfaces are sufficient for URLs using the generic syntax or the well known schemes. There are however more complex cases where it is desired to go beyond what the library offers:

To enable these use-cases, the library provides a suite of general facilities for processing low-ASCII character strings, and makes public the interface to useful rules found in rfc3986. The design goals of these facilities are:

The general facilities are nested in the fully qualified namespace boost::urls::grammar, while the headers for rfc3986-specific parsing algorithms are located in the <boost/url/rfc/> include directory. This section explains the design and use of the general facilities to define and parse new grammars.

Syntax Notation

The documentation and reference for this library use the Augmented Backus-Naur Form (ABNF) notation throughout to specify grammar rules. An understanding of this notation is necessary to achieve best results for learning how to use the custom parsing features.

[Note] Note

Code samples and identifiers in this customization section are written as if the following declarations are in effect:

#include <boost/url/grammar.hpp>

using namespace ::boost::urls::grammar;