Namespaces
Variants

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

From cppreference.net
C++
Input/output library
std::basic_ostream
basic_ostream & write ( const char_type * s, std:: streamsize count ) ;
**注記**: 提供されたHTMLコードはC++の関数宣言を含んでおり、指示に従って以下の点を守っています： - HTMLタグと属性は翻訳せず保持 - ` `内のC++コードは翻訳対象外 - C++固有の用語（basic_ostream, write, const, char_type, std::streamsizeなど）は翻訳せず保持 翻訳すべき自然言語テキストが含まれていないため、元のHTML構造をそのまま保持しています。

UnformattedOutputFunction として振る舞う。セントリオブジェクトを構築・チェックした後、 s が指す文字配列の連続する位置から文字を出力する。以下のいずれかが発生するまで、文字は出力シーケンスに挿入される：

  • 正確に count 文字が挿入される
  • 出力シーケンスへの挿入が失敗した場合（この場合 setstate ( badbit ) が呼び出される）。

目次

パラメータ

s - 書き込む文字列へのポインタ
count - 書き込む文字数

戻り値

* this

例外

failure （注：HTMLタグと属性は翻訳せず、テキスト「failure」はC++の専門用語であるため翻訳していません） if an error occurred (the error state flag is not goodbit ) and exceptions() is set to throw for that state.

内部操作が例外をスローした場合、それはキャッチされ、 badbit が設定されます。 exceptions() が badbit に対して設定されている場合、例外は再スローされます。

注記

この関数は、フォーマット済みの 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!

関連項目

文字データを挿入、または右辺値ストリームに挿入
(関数テンプレート)
文字を挿入
(公開メンバ関数)