Namespaces
Variants

std::basic_ofstream<CharT,Traits>:: basic_ofstream

From cppreference.net

C++
Input/output library
std::basic_ofstream
basic_ofstream ( ) ;
(1)
explicit basic_ofstream ( const char * filename,

std:: ios_base :: openmode mode

= std:: ios_base :: out ) ;
(2)
explicit basic_ofstream ( const std :: filesystem :: path :: value_type * filename,

std:: ios_base :: openmode mode

= std:: ios_base :: out ) ;
(3) (desde C++17)
explicit basic_ofstream ( const std:: string & filename,

std:: ios_base :: openmode mode

= std:: ios_base :: out ) ;
(4) (desde C++11)
template < class FsPath >

explicit basic_ofstream ( const FsPath & filename,
std:: ios_base :: openmode mode

= std:: ios_base :: out ) ;
(5) (desde C++17)
basic_ofstream ( basic_ofstream && other ) ;
(6) (desde C++11)
basic_ofstream ( const basic_ofstream & rhs ) = delete ;
(7) (desde C++11)

Construye un nuevo flujo de archivo.

1) Constructor por defecto: construye un flujo que no está asociado a un archivo: construye por defecto el std::basic_filebuf y construye la base con el puntero a este miembro std::basic_filebuf construido por defecto.
2,3) Primero, realiza los mismos pasos que el constructor por defecto, luego asocia el flujo con un archivo llamando a rdbuf ( ) - > open ( filename, mode | std:: ios_base :: out ) (ver std::basic_filebuf::open para los detalles sobre los efectos de esa llamada). Si la llamada a open() retorna un puntero nulo, establece setstate ( failbit ) . La sobrecarga (3) solo se proporciona si std :: filesystem :: path :: value_type no es char . (desde C++17)
4,5) Igual que basic_ofstream ( filename. c_str ( ) , mode ) . (5) participa en la resolución de sobrecarga solo si FsPath es std::filesystem::path . (desde C++17) Nótese que a pesar de que el modo por defecto es out , los efectos son idénticos a los efectos de out | trunc como se describe en std::filebuf::open
6) Constructor de movimiento. Primero, construye por movimiento la clase base desde other (lo cual no afecta el puntero rdbuf() ), luego construye por movimiento el miembro std::basic_filebuf , y luego llama a this - > set_rdbuf ( ) para instalar el nuevo basic_filebuf como el puntero rdbuf() en la clase base.
7) El constructor de copia está eliminado: esta clase no es copiable.

Contenidos

Parámetros

filename - el nombre del archivo a abrir
mode - especifica el modo de apertura del flujo. Se pueden usar las siguientes constantes y operaciones OR a nivel de bits entre ellas:
Constant Explicación
app buscar al final del flujo antes de cada escritura
binary abrir en modo binario
in abrir para lectura
out abrir para escritura
trunc descartar el contenido del flujo al abrir
ate buscar al final del flujo inmediatamente después de abrir
noreplace (C++23) abrir en modo exclusivo
other - otro flujo de archivo para usar como fuente

Ejemplo

Ejecutar este código 
#include <fstream>
#include <string>
#include <utility>
int main()
{
    std::ofstream f0;
    std::ofstream f1("test.bin", std::ios::binary);
    std::string name = "example.txt";
    std::ofstream f2(name);
    std::ofstream f3(std::move(f1));
}

Informes de defectos

Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares de C++ publicados anteriormente.

DR Aplicado a Comportamiento publicado Comportamiento correcto
LWG 3430 C++17 std::filesystem::path overload llevaba a conversiones no deseadas evitado al convertirlo en una plantilla

Véase también

abre un archivo y lo asocia con el flujo
(función miembro pública)
abre un archivo y lo configura como la secuencia de caracteres asociada
(función miembro pública de std::basic_filebuf<CharT,Traits> )
reemplaza el rdbuf sin limpiar su estado de error
(función miembro protegida)
construye el objeto
(función miembro pública de std::basic_ostream<CharT,Traits> )