Namespaces
Variants

std::basic_string_view<CharT,Traits>:: copy

From cppreference.net
C++
Strings library
std::basic_string_view
size_type copy ( CharT * dest, size_type count, size_type pos = 0 ) const ;
(depuis C++17)
(constexpr depuis C++20)

Copie la sous-chaîne [ pos , pos + rcount ) dans le tableau de caractères pointé par dest , où rcount est le plus petit entre count et size ( ) - pos .

Équivalent à Traits :: copy ( dest, data ( ) + pos, rcount ) .

Table des matières

Paramètres

dest - pointeur vers la chaîne de caractères de destination
count - longueur de sous-chaîne demandée
pos - position du premier caractère

Valeur de retour

Nombre de caractères copiés.

Exceptions

std::out_of_range si pos > size ( ) .

Complexité

Linéaire en rcount .

Exemple

Exécuter ce code 
#include <array>
#include <cstddef>
#include <iostream>
#include <stdexcept>
#include <string_view>
int main()
{
    constexpr std::basic_string_view<char> source{"ABCDEF"};
    std::array<char, 8> dest;
    std::size_t count{}, pos{};
    dest.fill('\0');
    source.copy(dest.data(), count = 4); // pos = 0
    std::cout << dest.data() << '\n'; // ABCD
    dest.fill('\0');
    source.copy(dest.data(), count = 4, pos = 1);
    std::cout << dest.data() << '\n'; // BCDE
    dest.fill('\0');
    source.copy(dest.data(), count = 42, pos = 2); // ok, count -> 4
    std::cout << dest.data() << '\n'; // CDEF
    try
    {
        source.copy(dest.data(), count = 1, pos = 666); // throws: pos > size()
    }
    catch (std::out_of_range const& ex)
    {
        std::cout << ex.what() << '\n';
    }
}

Sortie : 

ABCD
BCDE
CDEF
basic_string_view::copy: __pos (which is 666) > __size (which is 6)

Voir aussi

retourne une sous-chaîne
(fonction membre publique)
copie des caractères
(fonction membre publique de std::basic_string<CharT,Traits,Allocator> )
(C++11)
copie une série d'éléments vers un nouvel emplacement
(fonction template)
copie un tampon vers un autre
(fonction)