Boost C++ Libraries

...one 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 579430ad1f.

http::opt_token_list

A list of tokens in a comma separated HTTP field value.

Synopsis

Defined in header <boost/beast/http/rfc7230.hpp>

using opt_token_list = detail::basic_parsed_list< detail::opt_token_list_policy >;

Description

This container allows iteration of a list of items in a header field value. The input is a comma separated list of tokens.

If a parsing error is encountered while iterating the string, the behavior of the container will be as if a string containing only characters up to but excluding the first invalid character was used to construct the list.

BNF

token-list  = *( "," OWS ) token *( OWS "," [ OWS token ] )

To use this class, construct with the string to be parsed and then use begin and end, or range-for to iterate each item:

Example

for ( auto const & token : token_list{ "apple, pear, banana" })
    std::cout << token << "\n" ;