boost::urls::params_encoded_base::get_or :: Boost Libraries Documentation

# boost::urls::params_encoded_base::get_or

Return the value for a key or a fallback

## Synopsis

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

    pct_string_view
    get_or(
        pct_string_view key,
        pct_string_view value = {},
        ignore_case_param ic = {}) const noexcept;

## Description

This convenience function searches for the first parameter matching `key` and returns its percent‐encoded value. If no parameter with the specified key exists, the provided fallback `value` is returned instead. When the key is found but the corresponding parameter has no value, an empty string is returned.

## Example

    url_view u( "/path?first=John&last=Doe" );
    assert( u.encoded_params().get_or(
        "missing", "n%2Fa" ) == "n%2Fa" );

## Complexity

Linear in `this‐>buffer().size()`.

## Exception Safety

Throws nothing.

## Return Value

The encoded value or the fallback.

## Parameters

Name | Description
--- | ---
key | The key to match.
value | The fallback string returned when no matching key exists. If this parameter is omitted, an empty string is used.
ic | Optional case‐insensitive compare indicator.

Created with MrDocs