std::basic_filebuf<CharT,Traits>::setbuf
提供: cppreference.com
<tbody>
</tbody>
protected: virtual std::basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n ) |
||
s がヌルポインタかつ n がゼロの場合、 filebuf は出力に対してバッファなしになります。 つまり、 pbase() および pptr() がヌルになり、あらゆる出力は直ちにファイルに送られます。
そうでなければ、 setbuf() の呼び出しは内部のバッファ (制御された文字シーケンス) を最初の要素が s によって指されているユーザ提供の文字配列に置き換えます。 これにより、この std::basic_filebuf オブジェクトはバッファリングのためにその配列内の最大 n バイトを使用できるようになります。
この関数は protected virtual です。 pubsetbuf() を通して、または std::basic_filebuf から派生したユーザ定義のクラスのメンバ関数からのみ、呼ばれる可能性があります。
引数
| s | - | ユーザ提供バッファの最初の CharT へのポインタ、またはヌル |
| n | - | ユーザ提供バッファの CharT の要素数、またはゼロ |
戻り値
this。
ノート
この関数を使用できる状況および提供されたバッファの用途は処理系定義です。
- GCC 4.6 libstdc++
setbuf()は std::basic_filebuf がファイルと紐付けられていないときにのみ呼ぶことができます (そうでなければ効果を持ちません)。 ユーザ提供バッファを使用すると、ファイルから読み込みは一度にn-1バイト読み込みます。
- Clang++3.0 libc++
setbuf()はファイルを開いた後いかなる入出力も行う前に呼ぶことができます (そうでなければクラッシュする可能性があります)。 ユーザ提供バッファを使用すると、ファイルからの読み込みはそのバッファに収まる最大の 4096 の倍数を読み込みます。
- Visual Studio 2010
setbuf()はいつでも呼ぶことができます (入出力が行われた後でも構いません)。 バッファの現在の内容 (もしあれば) は失われます。
いかなる入出力も行われる前に setbuf(0, 0) が呼ばれるとバッファなし出力に設定されることが要求されることを除いて、標準はこの関数に対するいかなる動作も定義していません。
例
読み込み用に 10k のバッファを提供します。 Linux では実際に読み込まれたバイト数を観察するために strace ユーティリティを使用することができます。
Run this code
#include <fstream>
#include <iostream>
#include <string>
int main()
{
int cnt = 0;
std::ifstream file;
char buf[10241];
file.rdbuf()->pubsetbuf(buf, sizeof buf);
file.open("/usr/share/dict/words");
for (std::string line; getline(file, line); )
++cnt;
std::cout << cnt << '\n';
}
関連項目
setbuf() を呼びます ( std::basic_streambuf<CharT,Traits>のパブリックメンバ関数)
| |
| ファイルストリームのためのバッファとそのサイズを設定します (関数) |
