CFile::Read

virtual UINT Read( void* lpBuf, UINT nCount ); throw( CFileException );

Возвращаемое значение

Количество байт, записанных в буфер. Для всех классов, производных от класса CFile возвращаемое значение может быть меньше, чем значение аргумента nCount, если достигнут конец файла.

Аргументы

0. lpBuf — указатель на созданный пользователем буфер, в который будут записаны данный из файла.

1. nCount — количество байт, которые нужно считать из файла. Для текстовых файлов пара управляющих символов возврат каретки/перевод строки считается за один символ.

Примечание

Читает данные из файла, связанного с объектом класса CFile, в буфер.

Пример

extern CFile cfile;

char pbuf[100];

UINT nBytesRead = cfile.Read( pbuf, 100 );

CFile::Remove

static void PASCAL Remove( LPCTSTR lpszFileName ); throw( CFileException );

Аргументы

0. lpszFileName — текстовая строка, содержащая путь к уничтожаемому файлу. Путь может быть относительным или абсолютным, но не может содержать сетевого имени.

Примечание

Данная статическая функция уничтожает файл по его имени. Она не может использоваться для уничтожения директориев. Функция Remove вызывает исключение в том случае, если уничтожаемый файл открыт или не может быть уничтожен по другим причинам.

Пример

//Пример использования функции CFile::Remove

char* pFileName = "test.dat";

TRY

{

CFile::Remove( pFileName );

}

CATCH( CFileException, e )

{

#ifdef _DEBUG

afxDump << "Файл " << pFileName << " не может быть удалён \n";

#endif

}

END_CATCH

CFile::Seek

virtual LONG Seek( LONG lOff, UINT nFrom ); throw( CFileException );

Возвращаемое значение

Если указанная позиция расположена в файле, функция Seek возвращает новую текущую позицию в файле, равную смещению от начала файла, выраженному в байтах. В противном случае возвращаемое значение не определено и функция вызывает исключение CFileException.

Аргументы

0. lOff — количество байт, на которые необходимо переместить текущую позицию.

1. nFrom — флаг начала отсчёта. Может принимать следующие значения:

• CFile::begin — аргумент lOff определяет смещение от начала файла.

• CFile::current — аргумент lOff определяет смещение от текущей позиции файла.

• CFile::end — аргумент lOff определяет смещение от конца файла. В этом случае величина смещения должна быть отрицательной. При положительной величине смещения поиск будет производиться за концом файла.

Примечание

Перемещает текущую позицию в предварительно открытом файле. Функция Seek позволяет осуществить произвольный доступ к содержимому файла. При перемещении текущей позиции чтение информации не производится. При открытии файла он имеет нулевое смещение от начала файла.

Пример

extern CFile cfile;

LONG lOffset = 1000, lActual;

lActual = cfile.Seek( lOffset, CFile::begin );

CFile::SeekToBegin

void SeekToBegin( ); throw( CFileException );

Примечание

Устанавливает текущую позицию на начало файла. Функция SeekToBegin() эквивалентна функции Seek( 0L, CFile::begin ).

Пример

extern CFile cfile;

cfile.SeekToBegin();

CFile::SetLength

virtual void SetLength( DWORD dwNewLen ); throw( CFileException );

Аргументы

0. dwNewLen — новая длина файла в байтах. Значение данного аргумента может быть как больше, так и меньше текущей длины файла. При необходимости файл расширяется или урезается.

Примечание

Используется для изменения длины файла.

Пример

//Пример использования функции CFile::SetLength

extern CFile cfile;

DWORD dwNewLength = 10000;

cfile.SetLength( dwNewLength );