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

Se comporte comme une UnformattedOutputFunction . Après avoir construit et vérifié l'objet sentinelle, émet les caractères depuis des emplacements successifs dans le tableau de caractères dont le premier élément est pointé par s . Les caractères sont insérés dans la séquence de sortie jusqu'à ce que l'une des conditions suivantes se produise :

• exactement count caractères sont insérés
• l'insertion dans la séquence de sortie échoue (auquel cas setstate ( badbit ) est appelée).

Paramètres

Valeur de retour

* this

Exceptions

Si une opération interne lève une exception, elle est capturée et badbit est défini. Si exceptions() est défini pour badbit , l'exception est relancée.

Notes

Cette fonction n'est pas surchargée pour les types signed char ou unsigned char , contrairement à l' operator<< formaté.

De plus, contrairement aux fonctions de sortie formatées, cette fonction ne positionne pas le failbit en cas d'échec.

Lors de l'utilisation d'une locale non convertissante (la locale par défaut est non convertissante), le redéfinition de cette fonction dans std::basic_ofstream peut être optimisée pour les E/S en bloc sans copie (au moyen de la redéfinition de std::streambuf::xsputn ).

Exemple

#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!

Voir aussi