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

Ведут себя как UnformattedOutputFunction . После создания и проверки объекта-сторожа выводит символы из последовательных позиций в массиве символов, первый элемент которого указывается s . Символы вставляются в выходную последовательность до тех пор, пока не произойдет одно из следующих событий:

• вставляется ровно count символов
• вставка в выходную последовательность завершается неудачей (в этом случае вызывается setstate ( badbit ) ).

Параметры

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

* this

Исключения

Если внутренняя операция выбрасывает исключение, оно перехватывается и устанавливается badbit . Если для exceptions() установлен badbit , исключение перевыбрасывается.

Примечания

Эта функция не перегружена для типов signed char или unsigned char , в отличие от форматированного operator<< .

Кроме того, в отличие от функций форматированного вывода, эта функция не устанавливает failbit при ошибке.

При использовании неконвертирующей локали (локаль по умолчанию является неконвертирующей), переопределение этой функции в std::basic_ofstream может быть оптимизировано для массового ввода-вывода без копирования (посредством переопределения 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!

Смотрите также