std::basic_filebuf::setbuf — cppreference.com

Материал из cppreference.com

`protected: virtual std::basic_streambuf<CharT, Traits>* setbuf( char_type* s, std::streamsize n )`

Если s является нулевым указателем и n равна нулю, filebuf становится' небуферизованных для вывода, смысл pbase() и pptr() являются недействительными и любой выход немедленно направляется в файл.

Оригинал:

If s is a null pointer and n is zero, the filebuf becomes unbuffered for output, meaning pbase() and pptr() are null and any output is immediately sent to file.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

противном случае, вызов setbuf() заменяет внутренний буфера (управляемой последовательности символов) с пользователем массив символов, первый элемент, на который указывает s и позволяет этому объекту std::basic_filebuf использовать до n байтов в массиве для буферизации.

Оригинал:

Otherwise, a call to setbuf() replaces the internal buffer (the controlled character sequence) with the user-supplied character array whose first element is pointed to by s and allows this std::basic_filebuf object to use up to n bytes in that array for buffering.

Эта функция защищенных виртуальных, она может быть вызвана только через pubsetbuf() или члена функции пользовательского класса, производного от std::basic_filebuf.

Оригинал:

This function is protected virtual, it may only be called through pubsetbuf() or from member functions of a user-defined class derived from std::basic_filebuf.

Параметры

s	—	указатель на первый байт в предоставленное пользователем буфер или NULL Оригинал: pointer to the first byte in the user-provided buffer or null Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
n	—	количество байтов в предоставленное пользователем буфер или нуль Оригинал: the number of bytes in the user-provided buffer or zero Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Возвращаемое значение

*this, приведение к базовому классу std::basic_streambuf.

Оригинал:

*this, cast to the base class std::basic_streambuf.

Заметки

условия, когда эта функция может быть использована и способ, которым предоставлена буфер используется определяется реализацией.

Оригинал:

The conditions when this function may be used and the way in which the provided buffer is used is implementation-defined.

GCC 4,6 libstdc + +
Оригинал:
GCC 4.6 libstdc++
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

setbuf() может быть вызвана только когда std::basic_filebuf не связано с файлом (не имеет никакого эффекта в противном случае). Благодаря предоставленным пользователем буфера, чтение из файла читается n-1 байт за раз.

Оригинал:

setbuf() may only be called when the std::basic_filebuf is not associated with a file (has no effect otherwise). With a user-provided buffer, reading from file reads n-1 bytes at a time.

Clang + 3,0 Libc + +
Оригинал:
Clang++3.0 libc++
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

setbuf() может быть названа после открытия файла, но перед любой I / O (в противном случае может произойти сбой). Что предоставленные пользователем буфер , чтение из файла читается крупнейших кратные 4096, которые вписываются в буфер.

Оригинал:

setbuf() may be called after opening the file, but before any I/O (may crash otherwise). With a user-provided buffer, reading from file reads largest multiples of 4096 that fit in the buffer.

Visual Studio 2010
Оригинал:
Visual Studio 2010
Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

setbuf() может быть вызван в любое время, даже после некоторого I / O состоялся. текущее содержимое буфера, если таковые имеются, теряется.

Оригинал:

setbuf() may be called at any time, even after some I/O took place. Current contents of the buffer, if any, are lost.

стандарт не определяет никаких поведение для этой функции исключением того, что setbuf(0, 0) вызываться перед любой I / O состоялся необходимый для установки небуферизованный вывод.

Оригинал:

The standard does not define any behavior for this function except that setbuf(0, 0) called before any I/O has taken place is required to set unbuffered output.

Пример

обеспечить 10k буфер для чтения. В Linux, утилита Трассирование может быть использован для наблюдения за фактическое количество прочитанных байтов

Оригинал:

provide a 10k buffer for reading. On linux, the strace utility may be used to observe the actual number of bytes read

#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()

Оригинал:

invokes setbuf()

(public функция-элемент std::basic_streambuf) [править]

устанавливает буфер и его размер файлового потока

Оригинал:

sets the buffer and its size for a file stream

(функция) [править]

Категории: