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

> C++ Atlas: `cppatlas.com/w/cpp/experimental/basic_string_view/copy` | Source: https://en.cppreference.com/w/cpp/experimental/basic_string_view/copy | Domain: Technical specifications

Copies the substring [pos, pos + rcount) to the character string pointed to by dest, where rcount is the smaller of count and size() - pos.

## Official Specification Summary (cppreference)

```cpp
size_type copy( CharT* dest,
                size_type count,
                size_type pos = 0) const; // (library fundamentals TS)
```

Copies the substring `[pos, pos + rcount)` to the character string pointed to by `dest`, where `rcount` is the smaller of `count` and `size() - pos`.

### Parameters

- `dest` - pointer to the destination character string
- `pos` - position of the first character
- `count` - requested substring length

### Return value

Number of characters copied

### Exceptions

`std::out_of_range` if `pos > size()`.

### Complexity

Linear in `rcount`.

### See also

- [`substr`](https://en.cppreference.com/w/cpp/experimental/basic_string_view/substr): returns a substring (public member function)

---
Attribution: content from https://en.cppreference.com/w/cpp/experimental/basic_string_view/copy (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.