std::filesystem::directory_entry::exists

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca del sistema de archivos

Clases
filesystem::path filesystem::filesystem_error filesystem::directory_entry filesystem::directory_iterator filesystem::recursive_directory_iterator filesystem::file_status	filesystem::space_info filesystem::file_type filesystem::perms filesystem::perm_options filesystem::copy_options filesystem::directory_options filesystem::file_time_type
Funciones
filesystem::absolute filesystem::canonicalfilesystem::weakly_canonical filesystem::relativefilesystem::proximate filesystem::copy filesystem::copy_file filesystem::copy_symlink filesystem::create_directory filesystem::create_directories filesystem::create_hard_link filesystem::create_symlink filesystem::create_directory_symlink filesystem::current_path	filesystem::exists filesystem::equivalent filesystem::file_size filesystem::hard_link_count filesystem::last_write_time filesystem::permissions filesystem::read_symlink filesystem::remove filesystem::remove_all filesystem::rename filesystem::resize_file filesystem::space filesystem::status filesystem::symlink_status filesystem::temp_directory_path
Tipos de archivo
filesystem::is_block_file filesystem::is_character_file filesystem::is_directory filesystem::is_empty filesystem::status_known	filesystem::is_fifo filesystem::is_other filesystem::is_regular_file filesystem::is_socket filesystem::is_symlink

 

std::filesystem::directory_entry

Funciones miembro

directory_entry::directory_entry

Modificadores

directory_entry::operator=

directory_entry::assign

directory_entry::replace_filename

directory_entry::refresh

Observadores

directory_entry::pathdirectory_entry::operator const path&

directory_entry::exists

directory_entry::is_block_file

directory_entry::is_character_file

directory_entry::is_directory

directory_entry::is_fifo

directory_entry::is_other

directory_entry::is_regular_file

directory_entry::is_socket

directory_entry::is_symlink

directory_entry::file_size

directory_entry::hard_link_count

directory_entry::last_write_time

directory_entry::statusdirectory_entry::symlink_status

directory_entry::operator==directory_entry::operator!=directory_entry::operator<directory_entry::operator>directory_entry::operator<=directory_entry::operator>=directory_entry::operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)

Funciones no miembro

operator<<

 

<tbody> </tbody>

bool exists() const; bool exists( std::error_code& ec ) const noexcept;		(desde C++17)

Verifica si el objeto al que se apunta existe. Efectivamente devuelve std::filesystem::exists(status()) o std::filesystem::exists(status(ec)), respectivamente.

Parámetros

ec

-

El parámetro de salida para informe de errores en la sobrecarga que no lanza excepciones.

Valor de retorno

true si el objeto del sistema de archivos al que se hace referencia existe, false de lo contrario.

Excepciones

La sobrecarga que no toma un parámetro std::error_code& lanza filesystem::filesystem_error en los errores de la API del sistema operativo subyacente, construido con p como el primer argumento de la ruta de acceso y el código de error del sistema operativo como el argumento del código de error. La sobrecarga que toma un parámetro std::error_code& lo establece en el código de error de la API del sistema operativo si una llamada a la API del sistema operativo falla, y ejecuta ec.clear() si no ocurren errores. Cualquier sobrecarga que no está marcada con noexcept puede lanzar std::bad_alloc si la asignación de memoria falla.

Ejemplo

Ejecuta este código

#include <filesystem>
#include <fstream>
#include <iostream>
#include <string>

namespace fs = std::filesystem;

int main()
{
    // almacenar ruta actual y restaurarla a la salida
    const auto old_current_path = fs::current_path();

    // crear directorio "sanbox" en directorio temporal
    const auto dir_sandbox = fs::temp_directory_path() / "sandbox";

    if (!fs::create_directory(dir_sandbox)) {
        std::cout << "ERROR #1" << '\n';
        return -1;
    }

    fs::current_path(dir_sandbox); // cambiar al directorio justamente creado

    fs::directory_entry entry_sandbox { dir_sandbox };
    if (!entry_sandbox.exists()) {
        std::cout << "ERROR #2" << '\n';
        return -1;
    }

    std::cout << "Directorio actual: " << entry_sandbox.path().filename() << '\n';

    fs::path path_tmp_file = dir_sandbox / "tmp_file";

    std::ofstream file( path_tmp_file.string() ); // crear archivo regular
    file << "es.cppreference.com"; // escribir 19 bytes
    file.flush();

    fs::directory_entry entry_tmp_file{ path_tmp_file };

    if (entry_tmp_file.exists()) {
        std::cout << "Archivo " << entry_tmp_file.path().filename()
                  << " tiene tamaño: " << entry_tmp_file.file_size() << '\n';
    } else {
        std::cout << "ERROR #3" << '\n';
    }

    // limpieza
    fs::current_path(old_current_path);
    fs::remove_all(dir_sandbox);
}

Posible salida:

Directorio actual: "sandbox"
Archivo "tmp_file" tiene tamaño: 19

Véase también

exists (C++17)

Verifica si una ruta de acceso se refiere a un objeto existente del sistema de archivos. (función)