std::basic_string_view<CharT,Traits>::copy
De es.cppreference.net
size_type copy( CharT* dest, size_type count, size_type pos = 0 ) const;
|
(desde C++17) (constexpr desde C++20) |
|
Copia la subcadena [pos, pos + rcount) al arreglo de caracteres apuntado por dest, donde rcount es el menor entre count y size() - pos.
Equivalente a Traits::copy(dest, data() + pos, rcount).
Parámetros
| dest | - | puntero a la cadena de caracteres de destino |
| count | - | longitud de subcadena solicitada |
| pos | - | posición del primer carácter |
Valor de retorno
Número de caracteres copiados.
Excepciones
std::out_of_range si pos > size ( ) .
Complejidad
Lineal en
rcount
.
Ejemplo
Ejecutar este código
#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'; } }
Salida:
ABCD BCDE CDEF basic_string_view::copy: __pos (which is 666) > __size (which is 6)
Véase también
| devuelve una subcadena (función miembro pública) | |
| copia caracteres (función miembro pública de std::basic_string<CharT,Traits,Allocator>)
| |
(C++11) |
copia un rango de elementos a una nueva ubicación (plantilla de función & objeto de función de algoritmo) |
(C++20)(C++20) |
|
| copia un búfer a otro (función) |