std::basic_spanbuf<CharT,Traits>::span
From cppreference.com
< cpp | io | basic spanbuf
C++
Input/output library
| I/O manipulators | ||||
| Print functions (C++23) | ||||
| C-style I/O | ||||
| Buffers | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++20) | ||||
| Streams | ||||
| Abstractions | ||||
| File I/O | ||||
| String I/O | ||||
| Array I/O | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
(C++98/26*) | ||||
| Synchronized Output | ||||
(C++20) | ||||
| Types | ||||
| Error category interface | ||||
(C++11) | ||||
(C++11) |
std::basic_spanbuf
| Public member functions | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
basic_spanbuf::span (C++23) | ||||
| Protected member functions | ||||
(C++23) | ||||
(C++23) | ||||
(C++23) | ||||
| Non-member functions | ||||
(C++23) |
| std::span<CharT> span() const noexcept; |
(1) | (since C++23) |
| void span( std::span<CharT> s ) noexcept; |
(2) | (since C++23) |
1) Gets a
span referencing the written area if std::ios_base::out is set in the open mode, or a span referencing the underlying buffer otherwise.2) Makes the
basic_spanbuf perform I/O on the buffer referenced by s. Sets pointers to get area, put area, or both.
| Set bits in open mode (affecting pointers to get area) |
Return value after setting | ||
|---|---|---|---|
| eback() | gptr() | egptr() | |
| std::ios_base::in | s.data() | s.data() | s.data() + s.size() |
| Set bits in open mode (affecting pointers to put area) |
Return value after setting | ||
| pbase() | pptr() | epptr() | |
| std::ios_base::out && !std::ios_base::ate | s.data() | s.data() | s.data() + s.size() |
| std::ios_base::out && std::ios_base::ate | s.data() | s.data() + s.size() | s.data() + s.size() |
Contents |
[edit] Parameters
| s | - | a std::span that references the user-provided buffer |
[edit] Return value
1) std::span<CharT>(pbase(), pptr() if std::ios_base::out is set in the open mode, or a std::span<CharT> that references the whole underlying buffer otherwise.
2) (none)
[edit] Example
| This section is incomplete Reason: no example |
[edit] See also
| replaces or obtains a copy of the associated character string (public member function of std::basic_stringbuf<CharT,Traits,Allocator>) [edit]
| |
| (C++20) |
obtains a view over the underlying character sequence (public member function of std::basic_stringbuf<CharT,Traits,Allocator>) [edit]
|
| marks the buffer frozen and returns the beginning pointer of the input sequence (public member function of std::strstreambuf) [edit]
|