freopen, _wfreopen
Переназначает указатель файла. Существуют более безопасные версии этих функций; см. раздел freopen_s, _wfreopen_s.
FILE *freopen(
const char *path,
const char *mode,
FILE *stream
);
FILE *_wfreopen(
const wchar_t *path,
const wchar_t *mode,
FILE *stream
);
Параметры
path
Путь к новому файлу.mode
Тип разрешенного доступа.stream
Указатель на структуру FILE.
Возвращаемое значение
Каждая из этих функций возвращает указатель на вновь открытый файл. При возникновении ошибки, исходный файл закрывается, и функция возвращает значение указателя NULL. Если path, mode или stream является указателем на null, или если filename является пустой строкой, то эти функции вызывают обработчик недопустимого параметра, как описано в Проверка параметров. Если продолжение выполнения разрешено, эти функции устанавливают для errno значение EINVAL и возвращают NULL.
См. раздел _doserrno, errno, _sys_errlist, and _sys_nerr для дополнительных сведений по этим и другим кодам возврата.
Заметки
Существуют более безопасные версии этих функций, см. раздел freopen_s, _wfreopen_s.
Функция freopen закрывает файл, связанный в данный момент с stream, и связывает stream с файлом, указанным аргументом path*.* _wfreopen является версией _freopen для расширенных символов; аргументы path и mode в _wfreopen — строки расширенных символов. В остальных случаях поведение _wfreopen и _freopen идентично.
Универсальное текстовое сопоставление функций
Подпрограмма TCHAR.H |
_UNICODE & _MBCS не определены |
_MBCS определено |
_UNICODE определено |
|---|---|---|---|
_tfreopen |
freopen |
freopen |
_wfreopen |
freopen обычно используется для перенаправления заранее открытых файлов stdin, stdout и stderr на файлы, определенные пользователем. Новый файл, связанный с stream, открывается с mode*,* — символьной строкой, указывающей запрошенный тип доступа для файла, следующим образом:
"r"
Открывает для чтения. Если файл не существует или его невозможно найти, вызов freopen завершается ошибкой."w"
Открывает пустой файл для записи. Если указанный файл существует, его содержимое удаляется."a"
Открывает для записи в конце файла (добавление) без удаления маркера конца файла перед записью новых данных в файл; создает файл, если он не существует."r+"
Открывает для чтения и записи. (Файл должен существовать.)"w+"
Открывает пустой файл для чтения и записи. Если указанный файл существует, его содержимое удаляется."a+"
Открывает для чтения и добавления; операция добавления включает в себя удаление маркера конца файла до записи новых данных в файл и восстановление маркера конца файла после завершения записи; создает файл, если он не существует.
Используйте типы "w" и "w+" с осторожностью, поскольку они могут удалить существующие файлы.
Если файл открывается с помощью типа доступа "a" или "a+", все операции записи выполняются в конце файла. Хотя указатель файла может быть перемещен с помощью fseek или rewind, он всегда возвращается в конец файла перед выполнением любой операции записи. Таким образом, невозможно перезаписать существующие данные.
Режим "a" не удаляет маркер EOF перед добавлением в файл. После добавления команда MS-DOS TYPE отображает данные только до первоначального маркера EOF и не отображает данные, добавленные в файл. Перед добавлением в файл режим "a+" удаляет маркер EOF. После добавления команда TYPE MS-DOS отображает все данные в файле. Режим "a+" необходим для добавления в потоковый файл, завершаемый маркером конца файла CTRL+Z.
Если задан тип доступа "r+", "w+" или "a+", чтение и запись разрешены (считается, что файл открыт для "обновления"). Однако при переключении между чтением и записью должна быть промежуточная операция fsetpos, fseek или rewind. При необходимости, для операции fsetpos или fseek можно задать текущее положение. Помимо вышеуказанным значений, один из следующих символов может быть указан в строке mode для определения режима преобразования новых линий.
t
Открыть в текстовом режиме; сочетания символов возврата каретки и перевода строки преобразуются в один символ перевода строки на входе, а символы перевода строки преобразуются на выходе в сочетания символов возврата каретки и перевода строки. Также CTRL+Z интерпретируется как символ конца файла на входе. В файлах, открытых для чтения или для чтения и записи с "a+", библиотека времени выполнения проверяет на CTRL+Z в конце файла и удаляет его, если это возможно. Это делается потому, что использование fseek и ftell для перемещения в файле, который заканчивается CTRL+Z, может вызвать неправильное поведение fseek ближе к концу файла. Параметр t представляет собой расширение Майкрософт и не должен использоваться, если требуется обеспечить переносимость ANSI.b
Открытие файл в бинарном (непреобразованном) режиме; вышеописанные преобразования отключены.
Если символ t или b в параметре mode не указан, режим преобразования по умолчанию определяется глобальной переменной _fmode. Если символ t или b указан как префикс аргумента, функция завершается с ошибкой и возвращает NULL.
Обсуждение текстового и бинарного режимов см. в разделе Text and Binary Mode File I/O.
Требования
Функция |
Обязательный заголовок |
|---|---|
freopen |
<stdio.h> |
_wfreopen |
<stdio.h> или <wchar.h> |
Консоль не поддерживается в приложениях Магазин Windows. Стандартные дескрипторы потока, связанные с консолью — stdin, stdout и stderr — необходимо перенаправить, чтобы функции C времени выполнения могли использовать их в приложениях Магазин Windows. Дополнительные сведения о совместимости см. в разделе Совместимость.
Пример
// 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" );
}