std::basic_ostream<CharT,Traits>::write

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵器

打印函数 (C++23)

C 风格 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

std::basic_ostream

全局对象
coutwcout	cerrwcerr	clogwclog
成员函数
basic_ostream::basic_ostream
basic_ostream::~basic_ostream
basic_ostream::operator= (C++11)
格式化输出
basic_ostream::operator<<
非格式化输出
basic_ostream::put
basic_ostream::write
定位
basic_ostream::tellp
basic_ostream::seekp
杂项
basic_ostream::flush
basic_ostream::swap (C++11)
成员类
basic_ostream::sentry
非成员函数
operator<<(std::basic_ostream)
print(std::ostream) (C++23)
println(std::ostream) (C++23)
vprint_unicode(std::ostream) (C++23)
vprint_nonunicode(std::ostream) (C++23)

 

basic_ostream& write( const char_type* s, std::streamsize count );

行为类似于 UnformattedOutputFunction。在构造和检查 sentry 对象后，输出从字符数组中连续位置的字符，该字符数组的第一个元素由 s 指向。字符被插入到输出序列中，直到以下情况之一发生：

• 插入了正好 count 个字符
• 插入到输出序列失败（在这种情况下，将调用 setstate(badbit)）。

参数

s	-	指向要写入的字符字符串的指针
count	-	要写入的字符数

返回值

*this

异常

如果发生错误（错误状态标志不是 goodbit），并且 exceptions() 设置为对该状态抛出异常，则抛出 failure 异常。

如果内部操作抛出异常，则会捕获该异常，并将设置 badbit。如果为 badbit 设置了 exceptions()，则会重新抛出异常。

注释

与格式化的 operator<< 不同，此函数不会为类型 signed char 或 unsigned char 重载。

此外，与格式化输出函数不同，此函数不会在失败时设置 failbit。

当使用非转换区域设置（默认区域设置是非转换区域设置）时，std::basic_ofstream 中此函数的重写者可能会针对零复制批量 I/O 进行优化（通过重写 std::streambuf::xsputn）。

示例

此函数可用于输出对象表示，即二进制输出

运行此代码

#include <iostream>
 
int main()
{
    int n = 0x41424344;
    std::cout.write(reinterpret_cast<char*>(&n), sizeof n) << '\n';
 
    char c[] = "This is sample text.";
    std::cout.write(c, 4).write("!\n", 2);
}

可能的输出

DCBA
This!

另请参阅

operator<<(std::basic_ostream)	插入字符数据或插入到右值流 (函数模板)
put	插入一个字符 (公有成员函数)