Function copy

example/cacheHierarchy/fkYAML/node.hpp:2438–2445

@brief Copys the referenced character sequence values from `pos` by `n` size. @warning Throws an fkyaml::out_of_range exception if the given `pos` is bigger than the length. @param p_str The pointer to a character sequence buffer for output. @param n The number of elements to write into `p_str`. @param pos The offset of the beginning position to copy values. @return The number of elements to be wr

    /// @param pos The offset of the beginning position to copy values.
    /// @return The number of elements to be written into `p_str`.
    size_type copy(CharT* p_str, size_type n, size_type pos = 0) const {
        if FK_YAML_UNLIKELY (pos > m_len) {
            throw fkyaml::out_of_range(static_cast<int>(pos));
        }
        const size_type rlen = std::min(n, m_len - pos);
        traits_type::copy(p_str, mp_str + pos, rlen);
        return rlen;
    }

    /// @brief Constructs a sub basic_str_view object from `pos` by `n` size.
    /// @warning Throws an fkyaml::out_of_range exception if the given `pos` is bigger than the length.