Методы класса CArchive
Перед тем, как создать объект-архив класса CArchive, необходимо создать объект класса CFile. Связывая с объектом CFile файл на диске, нужно иметь в виду, что если нужно записать данные, то файл нужно открывать на запись, а если считать - то для чтения.
Конструктор класса CArchive имеет следующий вид:
CArchive(CFile* pFile, UINT nMode, int nBufSize=512, void* lpBuf=NULL);
Параметр pFile должен содержать указатель на объект класса CFile, из которого будут считываться или записываться данные. Перед вызовом конструктора файл, связанный с объектом pFile, должен быть уже открыт.
Параметр nMode определяет, будут ли данные записываться в файл или считываться из него: CArchive::load (данные будут считываться из файла на диске), CArchive::store (данные будут записываться в файл на диске).
Для операций чтения и записи в файл класс CArchive выполняет буферизацию. Размер этого буфера определяется необязательным параметром nBufSize. По умолчанию используется буфер размером 512 байт.
Конструктор класса CArchive сам получает у операционной системы блок оперативной памяти для буфера. Однако с помощью необязательного параметра lpBuf программист может предоставить ему собственный буфер. В этом случае параметр nBufSize должен указывать размер этого буфера.
Созданный объект класса CArchive можно будет использовать только для записи или только для чтения. Если необходимо сначала считать данные, а потом записать, следует создать для этого два отдельных объекта класса CArhive.
Нельзя применять методы класса CFile для доступа к файлу во время его использования совместно с объектами класса CArchive. Запись, чтение или перемещение указателя файла может вызвать нарушения во внутренней структуре файла архива.
Как уже отмечалось, метод Serialize класса документа вызывается объектами-архивами, когда приложение при необходимости читает или записывает состояние этого документа, вызывая методы CArchive::ReadObject и CArchive::WriteObject для объекта-архива. При этом методу Serialize передается ссылка на объект-архив, который и вызывает методы чтения или записи.
После использования методов
CArchive::ReadObject и
CArchive::WriteObjec t для восстановления или записи объектов, необходимо закрыть используемый для этого объект класса
CArchive. Для этого нужно вызвать метод
CArchive::Close.
После вызова этого метода нужно закрыть файл, cвязанный с объектом
CArchive, вызвав метод
CFile::Close, и удалить сам объект класса
CFile.
Запись в архивный файл
Когда приложение желает сохранить состояние объекта в файле, оно вызывает для него метод
Serialize. В качестве параметра этому методу передается указатель на объект класса
CArhive, связанный с файлом, открытым на запись.
Для того, чтобы определить, предназначен ли объект-архив для записи или для чтения, можно вызвать методы
CArchive::IsLoading или
CArchive::IsStoring.
Метод
IsStoring возвращает ненулевое значение, если данный объект предназначен для записи в файл, и нуль в противном случае. Метод
IsLoading является прямой противоположностью метода
IsStoring. Можно использовать любой метод для определения режима работы с объектом-архивом.
В случае записи в архивный файл реализация метода должна сохранить в файле все элементы данных, которые потом потребуется восстановить. Для этого необходимо воспользоваться оператором
<< или методами
WriteString и
Write, определенными в классе
CArchive.
Оператор << можно использовать, для записи в архивный файл переменных простых типов, например, long, int, char и объектов других классов, наследованных от класса
CObject.
Для записи в архивный файл массивов удобнее использовать метод
Write класса
CArchive. Он позволяет записать в файл определенное количество байт из указанного буфера памяти.
Если требуется сохранить строку символов, закрытую нулем, то гораздо удобнее вместо метода
Write использовать метод
WriteString. Метод
WriteString записывает в архивный файл строку, ограниченную нулевым символом.
Чтение из архивного файла
Опишем теперь, как восстановить записанное ранее состояние объекта из архивного файла.
Когда приложение желает восстановить состояние объекта данного класса, оно вызывает для него метод
Serialize. В качестве параметра этому методу передается указатель на объект класса
CArchive, связанного с файлом, открытым для чтения.
Реализация метода Serialize должна восстановить из файла все элементы данных, которые в него были записаны. Для этого можно воспользоваться оператором
>> или методами
ReadString и
Read, определенными в классе
CArchive.
Данные из архивного файла должны считываться в том же порядке, в каком они были в него записаны.
Оператор >> можно использовать, для чтения из архивного файла переменных простых типов, например, long, int, char и объектов других классов, наследованных от класса CObject.
Для чтения из архивного файла массивов, записанных в него методом Write, надо использовать метод
Read класса
CArchive. Он позволяет прочитать из файла определенное количество байт и записать его в указанный буфер.
Если требуется прочитать из архивного файла строку, записанную в него методом
WriteString, нужно воспользоваться методом
ReadString. В состав класса
CArchive входят два метода
ReadString, которые предназначены для записи из файла строки в объект класса
CString или в обычную строку.
Если надо записать прочитанную из архивного файла строку в массив символов, нужно воспользоваться другим прототипом метода
ReadString.
Содержание раздела