Re: Opinions on introduction of string_view in Core

From: Vinnie Falco (vinnie.falco_at_[hidden])
Date: 2021-10-19 01:52:31

On Mon, Oct 18, 2021 at 6:13 PM Andrey Semashev via Boost
<boost_at_[hidden]> wrote:
> How would you
> document the APIs that would use boost::core::detail::string_view

Like this:

    namespace boost {
    namespace json {

    /** The type of string_view used by the library

        This type is used when a non-owning reference
        to a character buffer is passed by parameter
        or returned by value.

        For full details see
        <a href="https://en.cppreference.com/w/cpp/string/basic_string_view"
            >std::string_view (cppreference.com)</a>
    */
    #ifdef BOOST_JSON_DOCS
    using string_view = __see_below__
    #else
    using string_view = boost::core::detail::string_view;
    #endif

    } // json
    } // boost