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

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

入出力ライブラリ

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 によって指されている文字配列から successive な位置の文字を出力します。次のいずれかが発生するまで、文字が出力シーケンスに挿入されます。

• ちょうど count 文字が挿入される
• 出力シーケンスへの挿入が失敗する (その場合、setstate(badbit) が呼び出されます)。

パラメータ

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

戻り値

*this

例外

failure: エラーが発生した場合（エラー状態フラグが goodbit ではない）で、exceptions() がその状態に対してスローするように設定されている場合。

内部操作が例外をスローした場合、それはキャッチされ、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!

関連項目

operator<<(std::basic_ostream)	文字データを挿入する、または右辺値ストリームに挿入する (function template)
put	文字を挿入する (public member function)