std::basic_filebuf<CharT,Traits>:: open

Si el archivo asociado ya estaba abierto ( is_open ( ) ! = false ), retorna un puntero nulo inmediatamente.

De lo contrario, abre el archivo con el nombre dado ( s , p. c_str ( ) (desde C++17) o str. c_str ( ) , dependiendo de la sobrecarga). Los valores std::ios_base::openmode pueden escribirse como, por ejemplo, std:: ios_base :: out | std:: ios_base :: app .

El archivo se abre como si se llamara a std::fopen con el segundo argumento (modo de acceso al archivo) determinado por el resultado de mode & ~ std:: ios_base :: ate como sigue, open() falla si el resultado no es alguna combinación de banderas mostradas en la tabla:

Si la operación de apertura tiene éxito y ( openmode & std:: ios_base :: ate ) ! = 0 (el bit ate está activado), reposiciona la posición del archivo al final del mismo, como si se llamara a std:: fseek ( file, 0 , SEEK_END ) , donde file es el puntero devuelto al llamar a std::fopen . Si el reposicionamiento falla, llama a close() y devuelve un puntero nulo para indicar el fallo.

Parámetros

Valor de retorno

this en caso de éxito, un puntero nulo en caso de fallo.

Notas

open() normalmente se llama a través del constructor o la función miembro open() de std::basic_fstream .

Ejemplo

#include <fstream>
#include <iostream>
int main()
{
    std::string filename = "Test.b";
    std::filebuf fb;
    // preparar un archivo para lectura
    double d = 3.14;
    if (!fb.open(filename, std::ios::binary | std::ios::out))
    {
        std::cout << "La apertura del archivo " << filename << " para escritura falló\n";
        return 1;
    } 
    fb.sputn(reinterpret_cast<char*>(&d), sizeof d);
    fb.close();
    // abrir archivo para lectura
    double d2 = 0.0;
    if (!fb.open(filename, std::ios::binary | std::ios::in))
    {
        std::cout << "La apertura del archivo " << filename << " para lectura falló\n";
        return 1;
    }
    auto got = fb.sgetn(reinterpret_cast<char*>(&d2), sizeof d2);
    if (sizeof(d2) != got)
        std::cout << "La lectura de " << filename << " falló\n";
    else
        std::cout << "Lectura recuperada del archivo: " << d2 << '\n';
}

Lectura recuperada del archivo: 3.14

Informes de defectos

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

Véase también