boost::urls::static_url::set_query :: Boost Libraries Documentation

# boost::urls::static_url::set_query

Set the query

## Synopsis

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

    static_url&
    set_query(core::string_view s);

## Description

This sets the query to the string, which can be empty. An empty query is distinct from having no query. Reserved characters in the string are percent‐escaped in the result.

## Example

    assert( url( "http://example.com" ).set_query( "id=42" ).query() == "id=42" );

## Postconditions

    this->has_query() == true && this->query() == s

## Exception Safety

Strong guarantee. Calls to allocate may throw.

## BNF

    query           = *( pchar / "/" / "?" )

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

## Specification

- 3.4. Query (rfc3986)

- Query string (Wikipedia)

## Return Value

`*this`

## Parameters

Name | Description
--- | ---
s | The string to set.

## See Also

`encoded_params`, `params`, `remove_query`, `set_encoded_query`.

Created with MrDocs