标准库标头 <spanstream> (C++23)

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏(C++20)

语言支持库

概念库(C++20)

诊断库

内存管理库

元编程库(C++11)

通用工具库

容器库

迭代器库

范围库(C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库(C++17)

并发支持库(C++11)

执行控制库(C++26)

技术规范

符号索引

外部库

 

标准库头

语言支持 <cfloat> <climits> <compare>(C++20) <contracts>(C++26) <coroutine>(C++20) <csetjmp> <csignal> <cstdarg> <cstddef> <cstdint>(C++11) <cstdlib> <exception> <initializer_list>(C++11)    <limits> <new> <source_location>(C++20) <stdfloat>(C++23) <typeinfo> <version>(C++20) 概念 <concepts>(C++20) 诊断 <cassert> <cerrno> <debugging>(C++26) <stacktrace>(C++23) <stdexcept> <system_error>(C++11) 内存管理 <memory> <memory_resource>(C++17) <scoped_allocator>(C++11) 元编程 <type_traits>(C++11) <ratio>(C++11)

通用工具 <any>(C++17) <bitset> <bit>(C++20) <charconv>(C++17) <expected>(C++23) <format>(C++20) <functional> <optional>(C++17) <stdbit.h>(C++26) <tuple>(C++11) <typeindex>(C++11) <utility> <variant>(C++17) 容器 <array>(C++11) <deque> <flat_map>(C++23) <flat_set>(C++23) <forward_list>(C++11) <hive>(C++26) <inplace_vector>(C++26)    <list> <map> <mdspan>(C++23) <queue> <set> <span>(C++20) <stack> <unordered_map>(C++11) <unordered_set>(C++11) <vector> 迭代器 <iterator> 范围 <generator>(C++23) <ranges>(C++20)

算法 <algorithm> <numeric> 字符串 <cctype> <cstring> <cuchar>(C++11) <cwchar> <cwctype> <string_view>(C++17) <string> 文本处理 <clocale> <codecvt>(C++11/17/26*) <locale> <regex>(C++11) <text_encoding>(C++26)    cpp/header#数值库数值 <cfenv>(C++11) <cmath> <complex> <linalg>(C++26) <numbers>(C++20) <random>(C++11) <simd>(C++26) <stdckdint.h>(C++26) <valarray> 时间 <chrono>(C++11) <ctime> C 兼容性 <ccomplex>(C++11/17/20*) <ciso646>(C++20 前) <cstdalign>(C++11/17/20*) <cstdbool>(C++11/17/20*) <ctgmath>(C++11/17/20*)

输入/输出 <cinttypes>(C++11) <cstdio> <filesystem>(C++17) <fstream> <iomanip> <iosfwd> <iostream> <ios> <istream> <ostream> <print>(C++23) <spanstream>(C++23) <sstream> <streambuf> <strstream>(C++98/26*) <syncstream>(C++20) 并发支持 <atomic>(C++11) <barrier>(C++20) <condition_variable>(C++11) <future>(C++11) <hazard_pointer>(C++26) <latch>(C++20) <mutex>(C++11) <rcu>(C++26) <semaphore>(C++20) <shared_mutex>(C++14) <stdatomic.h>(C++23) <stop_token>(C++20) <thread>(C++11) 执行支持 <execution>(C++17)

 

此头文件是输入/输出库的一部分。

类
basic_spanbuf (C++23)	实现原始固定字符缓冲区设备 (类模板)
basic_ispanstream (C++23)	实现固定字符缓冲区输入操作 (类模板)
basic_ospanstream (C++23)	实现固定字符缓冲区输出操作 (类模板)
basic_spanstream (C++23)	实现固定字符缓冲区输入/输出操作 (类模板)
spanbuf(C++23)	std::basic_spanbuf<char> (typedef)
wspanbuf(C++23)	std::basic_spanbuf<wchar_t> (typedef)
ispanstream(C++23)	std::basic_ispanstream<char> (typedef)
wispanstream(C++23)	std::basic_ispanstream<wchar_t> (typedef)
ospanstream(C++23)	std::basic_ospanstream<char> (typedef)
wospanstream(C++23)	std::basic_ospanstream<wchar_t> (typedef)
spanstream(C++23)	std::basic_spanstream<char> (typedef)
wspanstream(C++23)	std::basic_spanstream<wchar_t> (typedef)
函数
std::swap(std::basic_spanbuf) (C++23)	特化 std::swap 算法 (函数模板)
std::swap(std::basic_ispanstream) (C++23)	特化 std::swap 算法 (函数模板)
std::swap(std::basic_ospanstream) (C++23)	特化 std::swap 算法 (函数模板)
std::swap(std::basic_spanstream) (C++23)	特化 std::swap 算法 (函数模板)

概要

namespace std {template<class CharT, class Traits = char_traits<CharT>>class basic_spanbuf;   using spanbuf = basic_spanbuf<char>;using wspanbuf = basic_spanbuf<wchar_t>;   template<class CharT, class Traits = char_traits<CharT>>class basic_ispanstream;   using ispanstream = basic_ispanstream<char>;using wispanstream = basic_ispanstream<wchar_t>;   template<class CharT, class Traits = char_traits<CharT>>class basic_ospanstream;   using ospanstream = basic_ospanstream<char>;using wospanstream = basic_ospanstream<wchar_t>;   template<class CharT, class Traits = char_traits<CharT>>class basic_spanstream;   using spanstream = basic_spanstream<char>;using wspanstream = basic_spanstream<wchar_t>;}

类模板 std::basic_spanbuf

namespace std {template<class CharT, class Traits = char_traits<CharT>>class basic_spanbuf :public basic_streambuf<CharT, Traits>{public:using char_type = CharT;using int_type =typename Traits::int_type;using pos_type =typename Traits::pos_type;using off_type =typename Traits::off_type;using traits_type = Traits;   // 构造函数 basic_spanbuf(): basic_spanbuf(ios_base::in| ios_base::out){}explicit basic_spanbuf(ios_base::openmode which): basic_spanbuf(std::span<CharT>(), which){}explicit basic_spanbuf(std::span<CharT> s, ios_base::openmode which = ios_base::in| ios_base::out); basic_spanbuf(const basic_spanbuf&)= delete; basic_spanbuf(basic_spanbuf&& rhs);   // 赋值与交换 basic_spanbuf& operator=(const basic_spanbuf&)= delete; basic_spanbuf& operator=(basic_spanbuf&& rhs);void swap(basic_spanbuf& rhs);   // 获取与设置std::span<CharT> span()constnoexcept;void span(std::span<CharT> s)noexcept;   protected:// 重写的虚函数 basic_streambuf<CharT, Traits>* setbuf(CharT*, streamsize) override; pos_type seekoff(off_type off, ios_base::seekdir way, ios_base::openmode which = ios_base::in| ios_base::out) override; pos_type seekpos(pos_type sp, ios_base::openmode which = ios_base::in| ios_base::out) override;   private: ios_base::openmode mode;// 仅用于阐释std::span<CharT> buf;// 仅用于阐释};   template<class CharT, class Traits>void swap(basic_spanbuf<CharT, Traits>& x, basic_spanbuf<CharT, Traits>& y);}

类模板 std::basic_ispanstream

namespace std {template<class CharT, class Traits = char_traits<CharT>>class basic_ispanstream :public basic_istream<CharT, Traits>{public:using char_type = CharT;using int_type =typename Traits::int_type;using pos_type =typename Traits::pos_type;using off_type =typename Traits::off_type;using traits_type = Traits;   // 构造函数explicit basic_ispanstream(std::span<CharT> s, ios_base::openmode which = ios_base::in); basic_ispanstream(const basic_ispanstream&)= delete; basic_ispanstream(basic_ispanstream&& rhs);template<class ROS>explicit basic_ispanstream(ROS&& s);   // 赋值与交换 basic_ispanstream& operator=(const basic_ispanstream&)= delete; basic_ispanstream& operator=(basic_ispanstream&& rhs);void swap(basic_ispanstream& rhs);   // 成员 basic_spanbuf<CharT, Traits>* rdbuf()constnoexcept;std::span<const CharT> span()constnoexcept;void span(std::span<CharT> s)noexcept;template<class ROS>void span(ROS&& s)noexcept;   private: basic_spanbuf<CharT, Traits> sb;// 仅用于阐释};   template<class CharT, class Traits>void swap(basic_ispanstream<CharT, Traits>& x, basic_ispanstream<CharT, Traits>& y);}

类模板 std::basic_ospanstream

namespace std {template<class CharT, class Traits = char_traits<CharT>>class basic_ospanstream :public basic_ostream<CharT, Traits>{public:using char_type = CharT;using int_type =typename Traits::int_type;using pos_type =typename Traits::pos_type;using off_type =typename Traits::off_type;using traits_type = Traits;   // 构造函数explicit basic_ospanstream(std::span<CharT> s, ios_base::openmode which = ios_base::out); basic_ospanstream(const basic_ospanstream&)= delete; basic_ospanstream(basic_ospanstream&& rhs);   // 赋值与交换 basic_ospanstream& operator=(const basic_ospanstream&)= delete; basic_ospanstream& operator=(basic_ospanstream&& rhs);void swap(basic_ospanstream& rhs);   // 成员 basic_spanbuf<CharT, Traits>* rdbuf()constnoexcept;std::span<CharT> span()constnoexcept;void span(std::span<CharT> s)noexcept;   private: basic_spanbuf<CharT, Traits> sb;// 仅用于阐释};   template<class CharT, class Traits>void swap(basic_ospanstream<CharT, Traits>& x, basic_ospanstream<CharT, Traits>& y);}

类模板 std::basic_spanstream

namespace std {template<class CharT, class Traits = char_traits<CharT>>class basic_spanstream :public basic_iostream<CharT, Traits>{public:using char_type = CharT;using int_type =typename Traits::int_type;using pos_type =typename Traits::pos_type;using off_type =typename Traits::off_type;using traits_type = Traits;   // 构造函数explicit basic_spanstream(std::span<CharT> s, ios_base::openmode which = ios_base::out| ios_base::in); basic_spanstream(const basic_spanstream&)= delete; basic_spanstream(basic_spanstream&& rhs);   // 赋值与交换 basic_spanstream& operator=(const basic_spanstream&)= delete; basic_spanstream& operator=(basic_spanstream&& rhs);void swap(basic_spanstream& rhs);   // 成员 basic_spanbuf<CharT, Traits>* rdbuf()constnoexcept;std::span<CharT> span()constnoexcept;void span(std::span<CharT> s)noexcept;   private: basic_spanbuf<CharT, Traits> sb;// 仅用于阐释};   template<class CharT, class Traits>void swap(basic_spanstream<CharT, Traits>& x, basic_spanstream<CharT, Traits>& y);}