boost::urls::params_view::params_view :: Boost Libraries Documentation

# boost::urls::params_view::params_view

Constructor

## Synopsis

Declared in `<boost/url/params_view.hpp>`

    params_view(core::string_view s);

## Description

This function constructs params from a valid query parameter string, which can contain percent escapes. Unlike the parameters in URLs, the string passed here should not start with "?". Upon construction, the view references the character buffer pointed to by `s`. The caller is responsible for ensuring that the lifetime of the buffer extends until it is no longer referenced.

## Example

    params_view qp( "first=John&last=Doe" );

## Effects

    return parse_query( s ).value();

## Postconditions

    this->buffer().data() == s.data()

## Complexity

Linear in `s`.

## Exception Safety

Exceptions thrown on invalid input.

## BNF

    query-params    = [ query-param ] *( "&" query-param )

    query-param     = key [ "=" value ]

## Specification

- https://datatracker.ietf.org/doc/html/rfc3986#section-3.4

## Exceptions

Name | Thrown on
`system_error` | `s` contains an invalid query parameter string.

## Parameters

Name | Description
s | The string to parse.

Created with MrDocs