Страница 113 из 238
Dump
virtual void Dump(CDumpContext& dc) const;
Аргументы
- dc - объект класса, осуществляющего потоковый вывод отладочной информации. Обычно это используемый по умолчанию объект afxDump.
Описание
Передает содержимое пользовательского объекта в объект класса
CDumpContext. При создании пользовательского класса необходимо перегрузить функцию
Dump, чтобы обеспечить выдачу диагностических сообщений об ошибках, произошедших в объекте данного класса. Обычно, первым оператором перегруженной функции является вызов соответствующей функции базового класса. Функция
CObject::Dump печатает имя класса, если при его создании использовались макросы
IMPLEMENT_DYNAMIC или
IMPLEMENT_SERIAL. При выводе пользовательской информации перегруженная функция
Dump не должна использовать символа перевода каретки в конце своей работы. Данная функция работает только в отладочной версии библиотеки MFC и ее описание должно располагаться между операторами условной трансляции
#ifdef _DEBUG и
#endif. Поскольку функция
Dump является функцией-константой, пользователь не может изменять значения величин в проверяемом объекте. Функция
Dump вызывается перегруженным оператором записи объекта
CDumpContext::operator << при записи указателя на объект класса
CObject. Функция
Dump не предполагает рекуррентности, то есть пользователь может распечатать список объектов, но если один из объектов сам является списком, то его содержимое не будет распечатано.
