freopen_s, _wfreopen_s

 

Para obtener la documentación más reciente de Visual Studio 2017 RC, consulte Documentación de Visual Studio 2017 RC.

Reasigna un puntero de archivo. Estas versiones de freopen, _wfreopen tienen mejoras de seguridad, como se describe en características de seguridad de CRT.

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

Parámetros

[out] pFile
Puntero al puntero de archivo que la llamada va a proporcionar.

[in] path
Ruta de acceso del nuevo archivo.

[in] mode
Tipo de acceso permitido.

[in] stream
Puntero a la estructura FILE .

Cada una de estas funciones devuelve un código de error. Si se produce un error, el archivo original se cierra.

El freopen_s función cierra el archivo asociado actualmente a stream y reasigna stream en el archivo especificado por path. _wfreopen_s es una versión con caracteres anchos de _freopen_s; el path y mode argumentos _wfreopen_s son cadenas de caracteres anchos. Por lo demás, _wfreopen_s y _freopen_s se comportan de forma idéntica.

Si alguno de pFile, path, mode, o stream son NULL, o si path es una cadena vacía, estas funciones invocan el controlador de parámetros no válidos, como se describe en validación del parámetro. Si la ejecución puede continuar, estas funciones establecen errno en EINVAL y devuelven EINVAL.

Asignaciones de rutina de texto genérico

Rutina TCHAR.H_UNICODE y _MBCS no definidos_MBCS definido_UNICODE definido
_tfreopen_sfreopen_sfreopen_s_wfreopen_s

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

"r"
Abre para lectura. Si el archivo no existe o no se encuentra, la llamada de freopen_s falla.

"w"
Abre un archivo vacío para escritura. Si el archivo especificado existe, se destruye su contenido.

"a"
Abre para escribir al final del archivo (anexar) sin quitar el marcador EOF antes de escribir nuevos datos en archivo; primero 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 especificado existe, se destruye su contenido.

"a+"
Abre para leer y anexar. La operación para anexar incluye la eliminación del marcador EOF antes de escribir los nuevos datos en el archivo; el marcador se restablece cuando se finaliza la escritura. Primero crea el archivo si no existe.

Use los tipos "w" y "w+" con cuidado, ya que podrían destruir archivos existentes.

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. Si bien el puntero de archivo se puede mover mediante fseek o rewind, siempre se desplaza al final del archivo antes de que se realice cualquier operación de escritura. Por consiguiente, los datos existentes no pueden sobrescribirse.

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 el "r+",``"w+", o "a+" se especifica el tipo de acceso, se permiten la lectura y escritura (se dice el archivo abierto para "actualización"). Sin embargo, cuando cambia entre lectura y escritura, debe haber un intermedia fsetpos, fseek, o rebobinar operación. Si se desea, 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.

t
Abrir en 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 hace así porque el uso de fseek y ftell para desplazarse por un archivo puede hacer que fseek se comporte de forma incorrecta cerca del final del archivo. La opción t es una extensión de Microsoft que no se debe usar si se desea disponer de portabilidad de ANSI.

b
Abrir en modo binario (sin traducir); las conversiones anteriores se suprimen.

Si no se especifica t o b en mode, el modo de traducción predeterminado está definido por 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 explicación de los modos de texto y binarios, consulte texto y E/S de archivo binario de modo.

FunciónEncabezado necesario
freopen_s<stdio.h>
_wfreopen_s<stdio.h> o <wchar.h>

La consola no se admite en las aplicaciones de Tienda Windows 8.x. Se deben redirigir los identificadores estándar de flujo que están asociados a la consola, stdin, stdout y stderr, antes de que las funciones en tiempo de ejecución de C puedan usarlos en aplicaciones de Tienda Windows 8.x. Para obtener más información sobre compatibilidad, vea Compatibilidad.

// crt_freopen_s.c  
// 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 )  
{  
   errno_t err;  
   // Reassign "stderr" to "freopen.out":   
   err = freopen_s( &stream, "freopen.out", "w", stderr );  
  
   if( err != 0 )  
      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'  

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

Mostrar: