value::try_as_string

## `value::try_as_string`

Return `result` with a reference to the underlying `string`.

### Synopsis

    boost::system::result< string & >
    try_as_string() noexcept; (1)

    boost::system::result< string const & >
    try_as_string() const noexcept; (2)

### Description

If `is_string()` is `true`, the result contains a reference to the underlying `string`, otherwise it contains an `error_code`.

### Example

The return value can be used in both a boolean context and to assign a variable:

    if( auto r = jv.try_as_string() )
        return *r;

But can also be used to throw an exception on error:

    return jv.try_as_string().value();

### Complexity

Constant.

### Exception Safety

No-throw guarantee.

Edit this page