Manejo de archivos y directorios en C++ con las funciones de la API de Windows
Para interactuar con archivos y directorios en Windows utilizando C++, necesitamos trabajar con funciones específicas de la API de Windows. Estas funciones nos permiten realizar operaciones como la creación de archivos, lectura y escritura en ellos, obtener información sobre directorios y manejar errores relacionados con el acceso al sistema de archivos.
El archivo de cabecera principal que debemos incluir es Windows.h, que nos proporciona acceso a todas las funciones necesarias.
Operaciones con archivos
A continuación, veremos algunas de las funciones más comunes de la API de Windows para el manejo de archivos en C++.
1. Crear y abrir archivos
La función CreateFile es la más utilizada para crear o abrir archivos en Windows. Esta función permite especificar el modo de acceso (lectura, escritura o ambos), el modo de compartición y otras opciones de control.
#include <Windows.h>
#include <iostream>
int main() {
HANDLE hFile = CreateFile(
"archivo.txt", // Nombre del archivo
GENERIC_WRITE, // Acceso de escritura
0, // No compartir
NULL, // Atributos de seguridad
CREATE_ALWAYS, // Crear un nuevo archivo o sobrescribir el existente
FILE_ATTRIBUTE_NORMAL, // Atributos por defecto
NULL // No hay plantilla
);
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error al crear o abrir el archivo." << std::endl;
return 1;
}
std::cout << "Archivo creado o abierto correctamente." << std::endl;
CloseHandle(hFile); // Cerrar el archivo
return 0;
}
En este ejemplo, CreateFile crea o abre un archivo llamado archivo.txt. Si el archivo no existe, lo crea. Si existe, lo sobrescribe. El acceso especificado es de escritura (GENERIC_WRITE), pero puede modificarse para lectura (GENERIC_READ) o ambos (GENERIC_READ | GENERIC_WRITE).
2. Escribir en archivos
Para escribir datos en un archivo, se puede utilizar la función WriteFile. Esta función permite escribir un buffer de datos en el archivo.
#include <Windows.h>
#include <iostream>
int main() {
HANDLE hFile = CreateFile(
"archivo.txt", GENERIC_WRITE, 0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, NULL);
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error al abrir el archivo." << std::endl;
return 1;
}
const char* texto = "Escribiendo en un archivo usando la API de Windows.\n";
DWORD bytesEscritos;
if (!WriteFile(hFile, texto, strlen(texto), &bytesEscritos, NULL)) {
std::cerr << "Error al escribir en el archivo." << std::endl;
CloseHandle(hFile);
return 1;
}
std::cout << "Datos escritos en el archivo correctamente." << std::endl;
CloseHandle(hFile);
return 0;
}
En este ejemplo, la función WriteFile escribe una cadena de texto en el archivo. El parámetro bytesEscritos almacena la cantidad de bytes que fueron escritos correctamente.
3. Leer archivos
Para leer datos de un archivo, podemos utilizar la función ReadFile. Esta función lee un número especificado de bytes del archivo abierto.
#include <Windows.h>
#include <iostream>
int main() {
HANDLE hFile = CreateFile(
"archivo.txt", GENERIC_READ, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
if (hFile == INVALID_HANDLE_VALUE) {
std::cerr << "Error al abrir el archivo." << std::endl;
return 1;
}
char buffer[100];
DWORD bytesLeidos;
if (ReadFile(hFile, buffer, sizeof(buffer) - 1, &bytesLeidos, NULL)) {
buffer[bytesLeidos] = '\0'; // Asegurar que el buffer es una cadena válida
std::cout << "Datos leídos del archivo:\n" << buffer << std::endl;
} else {
std::cerr << "Error al leer el archivo." << std::endl;
}
CloseHandle(hFile);
return 0;
}
En este ejemplo, ReadFile lee datos del archivo y los almacena en un buffer. Luego, el buffer se imprime en la consola.
4. Eliminar archivos
Para eliminar un archivo, la API de Windows proporciona la función DeleteFile.
#include <Windows.h>
#include <iostream>
int main() {
if (DeleteFile("archivo.txt")) {
std::cout << "Archivo eliminado correctamente." << std::endl;
} else {
std::cerr << "Error al eliminar el archivo." << std::endl;
}
return 0;
}
DeleteFile elimina el archivo especificado, devolviendo TRUE en caso de éxito y FALSE si ocurre un error.
Operaciones con directorios
Además del manejo de archivos, la API de Windows también nos permite realizar operaciones con directorios. A continuación, exploraremos algunas de las funciones más útiles para trabajar con directorios.
1. Crear directorios
Para crear un directorio, utilizamos la función CreateDirectory.
#include <Windows.h>
#include <iostream>
int main() {
if (CreateDirectory("NuevoDirectorio", NULL)) {
std::cout << "Directorio creado correctamente." << std::endl;
} else {
std::cerr << "Error al crear el directorio." << std::endl;
}
return 0;
}
CreateDirectory crea un directorio con el nombre especificado. Si ya existe un directorio con ese nombre, la función falla.
2. Eliminar directorios
Para eliminar un directorio vacío, podemos usar la función RemoveDirectory.
#include <Windows.h>
#include <iostream>
int main() {
if (RemoveDirectory("NuevoDirectorio")) {
std::cout << "Directorio eliminado correctamente." << std::endl;
} else {
std::cerr << "Error al eliminar el directorio." << std::endl;
}
return 0;
}
RemoveDirectory elimina un directorio vacío. Si el directorio contiene archivos o subdirectorios, la función falla.
3. Enumerar archivos y directorios
Para listar archivos y subdirectorios dentro de un directorio, se utiliza la función FindFirstFile y FindNextFile.
#include <Windows.h>
#include <iostream>
int main() {
WIN32_FIND_DATA findFileData;
HANDLE hFind = FindFirstFile("NuevoDirectorio\\*", &findFileData);
if (hFind == INVALID_HANDLE_VALUE) {
std::cerr << "Error al abrir el directorio." << std::endl;
return 1;
}
do {
std::cout << "Archivo o directorio encontrado: " << findFileData.cFileName << std::endl;
} while (FindNextFile(hFind, &findFileData) != 0);
FindClose(hFind);
return 0;
}
Este código busca todos los archivos y subdirectorios dentro de NuevoDirectorio. FindFirstFile inicia la búsqueda y FindNextFile permite continuarla hasta que no queden más archivos por listar.
Conclusión
El manejo de archivos y directorios en C++ utilizando la API de Windows proporciona un control detallado y eficiente sobre el sistema de archivos. Desde la creación y manipulación de archivos hasta la gestión de directorios y la enumeración de su contenido, la API ofrece un conjunto de herramientas poderosas que pueden ser aprovechadas para desarrollar aplicaciones robustas y flexibles.
Con el conocimiento de las funciones básicas presentadas en este artículo, puedes empezar a construir aplicaciones que interactúen con el sistema de archivos de Windows de manera efectiva.
Jorge García
Fullstack developer