freopen, _wfreopen

Reasigna un puntero de archivo. Hay disponibles versiones más seguras de las funciones; vea freopen_s, _wfreopen_s.

Sintaxis

FILE *freopen(
   const char *path,
   const char *mode,
   FILE *stream
);
FILE *_wfreopen(
   const wchar_t *path,
   const wchar_t *mode,
   FILE *stream
);

Parámetros

path
Ruta de acceso del nuevo archivo.

mode
Tipo de acceso permitido.

stream
Puntero a la estructura FILE .

Valor devuelto

Cada una de estas funciones devuelve un puntero al archivo que se acaba de abrir. Si se produce un error, se cierra el archivo original y la función devuelve un NULL valor de puntero. Si pathes , modeo stream es un puntero nulo o si filename es una cadena vacía, estas funciones invocan al controlador de parámetros no válidos, como se describe en Validación de parámetros. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y devuelven NULL.

Para obtener más información sobre los códigos de error, vea errno, _doserrno, _sys_errlisty _sys_nerr.

Comentarios

Existen versiones más seguras de estas funciones, vea freopen_s, _wfreopen_s.

La freopen función cierra el archivo asociado actualmente a stream y reasigna stream al archivo especificado por path. _wfreopen es una versión con caracteres anchos de _freopen; los argumentos path y mode para _wfreopen son cadenas de caracteres anchos. Por lo demás,_wfreopen y _freopen se comportan de forma idéntica.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Asignaciones de rutinas de texto genérico

Rutina TCHAR.H	_UNICODE y _MBCS no definidos	_MBCS definido	_UNICODE definido
_tfreopen	freopen	freopen	_wfreopen

freopen se suele usar para redirigir los archivos ya abiertos stdin, stdout y stderr a los archivos especificados por el usuario. El nuevo archivo asociado a stream se abre con mode, que es una cadena de caracteres que especifica el tipo de acceso solicitado para el archivo, como se indica a continuación:

mode	Acceder
"r"	Abre para lectura. Si el archivo no existe o no se encuentra, la llamada freopen genera un error.
"w"	Abre un archivo vacío para escritura. Si el archivo especificado existe, se destruye su contenido.
"a"	Abre para escritura al final del archivo (anexo) sin eliminar el marcador de fin de archivo (EOF) antes de que se escriban nuevos datos en el archivo. Crea el archivo si no existe.
"r+"	Abre para lectura y escritura. El archivo debe existir.
"w+"	Abre un archivo vacío para lectura y escritura. Si el archivo existe, se destruye su contenido.
"a+"	Se abre para lectura y anexado. La operación de anexado incluye la eliminación del marcador EOF antes de que los nuevos datos se escriban en el archivo. El marcador EOF no se restablece una vez completada la escritura. Crea el archivo si no existe.

Use los tipos "w" y "w+" con cuidado, ya que podrían destruir archivos existentes. A partir de C11, puede anexar "x" a "w" o "w+" para provocar que se produzca un error en la función si el archivo existe en lugar de sobrescribirlo.

Si se abre un archivo con el tipo de acceso "a" o "a+", todas las operaciones de escritura se realizan en el final del archivo. Aunque el puntero de archivo se puede cambiar de posición mediante fseek o rewind, el puntero de archivo siempre se mueve al final del archivo antes de que se lleve a cabo cualquier operación de escritura. Por lo tanto, no se pueden sobrescribir los datos existentes.

El modo "a" no quita el marcador EOF antes de que se anexe contenido al archivo. Una vez realizado el anexado, el comando TYPE de MS-DOS solo muestra los datos hasta el marcador EOF original, y no los datos anexados al archivo. El modo "a+" quita el marcador EOF antes de que se anexe contenido al archivo. Después de anexar, el comando TYPE de MS-DOS muestra todos los datos del archivo. El modo "a+" se requiere para anexar a un archivo de streaming terminado con el marcador EOF CTRL+Z.

Cuando se especifica el tipo de acceso "r+", "w+" o "a+", se permiten la lectura y la escritura (el archivo está abierto para "actualización"). Sin embargo, si se cambia entre lectura y escritura, debe haber una operación intermedia fsetpos, fseek o rewind. Si se quiere, se puede especificar la posición actual para la operación fsetpos o fseek. Además de los valores anteriores, uno de los caracteres siguientes se puede incluir en la cadena de mode para especificar el modo de traducción para las nuevas líneas.

Modificador mode	Modo de traducción
t	Abra en modo de texto (traducido).
b	Abra en modo binario (sin traducir); las traducciones que implican los caracteres de retorno de carro y avance de línea se suprimen.

En el modo de texto (traducido); las combinaciones de retorno de carro-avance de línea (CR-LF) se convierten en caracteres únicos de avance de línea (LF) en la entrada; los caracteres de LF se traducen en combinaciones de CR-LF en la salida. Además, CTRL+Z se interpreta como carácter de final de archivo en la entrada. En archivos abiertos para lectura, o para escritura y lectura, con "a+", la biblioteca en tiempo de ejecución comprueba si hay un CTRL+Z al final del archivo y lo quita, si es posible. Se quita porque usar fseek y ftell mover dentro de un archivo puede provocar fseek que se comporte incorrectamente cerca del final del archivo. No use la opción t si quiere obtener portabilidad ANSI, ya que es una extensión de Microsoft.

Si no se especifica t o b en mode, el modo de traducción predeterminado lo define la variable global _fmode. Si se agrega t o b como prefijo al argumento, se produce un error en la función y devuelve NULL.

Para obtener una descripción de los modos de texto y binario, consulte E/S de archivo en modo texto y en modo binario.

Requisitos

Función	Encabezado necesario
freopen	<stdio.h>
_wfreopen	<stdio.h> o <wchar.h>

La consola no se admite en las aplicaciones de la Plataforma universal de Windows (UWP). Los identificadores de flujo estándar asociados a la consola, stdin, stdout y stderr, se deben redirigir antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones para UWP. Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Ejemplo

// crt_freopen.c
// compile with: /W3
// This program reassigns stderr to the file
// named FREOPEN.OUT and writes a line to that file.
#include <stdio.h>
#include <stdlib.h>

FILE *stream;

int main( void )
{
   // Reassign "stderr" to "freopen.out":
   stream = freopen( "freopen.out", "w", stderr ); // C4996
   // Note: freopen is deprecated; consider using freopen_s instead

   if( stream == NULL )
      fprintf( stdout, "error on freopen\n" );
   else
   {
      fprintf( stdout, "successfully reassigned\n" ); fflush( stdout );
      fprintf( stream, "This will go to the file 'freopen.out'\n" );
      fclose( stream );
   }
   system( "type freopen.out" );
}

successfully reassigned
This will go to the file 'freopen.out'

Consulte también

E/S de secuencia
fclose, _fcloseall
_fdopen, _wfdopen
_fileno
fopen, _wfopen
_open, _wopen
_setmode