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

< cpp‎ | io‎ | basic ostream
 
C++
 
输入/输出库
 
std::basic_ostream
 
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() ，则重抛该异常。

注解

此函数不对 signed char 或 unsigned char 类型重载，不同于有格式的 operator<< 。

而且，不同于有格式输出函数，此函数在失败时不设置 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

参阅

 插入字符数据
(函数)
插入字符
(公开成员函数)