CDumpContext Sınıfı

akış odaklı tanılama çıkışını insan tarafından okunabilir metin biçiminde destekler.

Sözdizimi

class CDumpContext

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Ortak İşleçler

Açıklamalar

CDumpContext temel sınıfına sahip değildir.

Dökümünüzün çoğu için önceden bildirilmiş CDumpContext bir nesne olan afxDump kullanabilirsiniz. afxDump nesnesi yalnızca Microsoft Foundation Sınıf Kitaplığı'nın Hata Ayıklama sürümünde kullanılabilir.

Bellek tanılama hizmetlerinin birkaçı çıktıları için kullanılır afxDump .

Windows ortamı altında, kavramsal olarak akışa benzer şekilde önceden tanımlanmış afxDump nesneden cerr elde edilen çıkış, Windows işlevi OutputDebugStringaracılığıyla hata ayıklayıcıya yönlendirilir.

sınıfı, CDumpContext nesnenin verilerinin dökümünü alan işaretçiler için CObject aşırı yüklenmiş bir ekleme ( <<) işlecine sahiptir. Türetilmiş nesne için özel döküm biçimine ihtiyacınız varsa CObject::D ump'yi geçersiz kılın. Microsoft Foundation sınıflarının çoğu geçersiz kılınmış Dump bir üye işlevi uygular.

, , ve gibi CStringCTimetüretilmemiş CObjectsınıfların, , ve CRectCTimeSpangibi CFileStatusCPointsık kullanılan yapılar gibi kendi aşırı yüklenmiş CDumpContext ekleme işleçleri vardır.

Sınıfınızın uygulamasında IMPLEMENT_DYNAMIC veya IMPLEMENT_SERIAL makroyu kullanırsanız, CObject::Dump türetilmiş sınıfınızın CObjectadını yazdırır. Aksi takdirde, yazdırır CObject.

CDumpContext sınıfı, kitaplığın hem Hata Ayıklama hem de Yayın sürümleriyle kullanılabilir, ancak Dump üye işlevi yalnızca Hata Ayıklama sürümünde tanımlanır. Özel Dump üye işlevleriniz de dahil olmak üzere tanılama kodunuzu köşeli ayraç içine almak için #ifdef _DEBUG / #endif deyimlerini kullanın.

Kendi CDumpContext nesnenizi oluşturmadan önce döküm hedefi olarak hizmet veren bir CFile nesne oluşturmanız gerekir.

hakkında CDumpContextdaha fazla bilgi için bkz . MFC Uygulamalarında Hata Ayıklama.

#define _DEBUG

Devralma Hiyerarşisi

CDumpContext

Gereksinimler

Üst bilgi: afx.h

CDumpContext::CDumpContext

sınıfının CDumpContextnesnesini oluşturur.

CDumpContext(CFile* pFile = NULL);

Parametreler

pFile
Döküm hedefi olan nesnenin işaretçisi CFile .

Açıklamalar

afxDump Nesnesi otomatik olarak oluşturulur.

Döküm bağlamı etkinken temel alınana CFile yazmayın; aksi takdirde dökümü engellersiniz. Windows ortamı altında çıkış, Windows işlevi OutputDebugStringaracılığıyla hata ayıklayıcıya yönlendirilir.

Örnek

CFile f;
if (!f.Open(_T("dump.txt"), CFile::modeCreate | CFile::modeWrite))
{
   AFXDUMP(_T("Unable to open file\n"));
   exit(1);
}
CDumpContext dc(&f);

CDumpContext::D umpAsHex

Belirtilen türü onaltılık sayılar olarak biçimlendirir.

CDumpContext& DumpAsHex(BYTE b);
CDumpContext& DumpAsHex(DWORD dw);
CDumpContext& DumpAsHex(int n);
CDumpContext& DumpAsHex(LONG l);
CDumpContext& DumpAsHex(LONGLONG n);
CDumpContext& DumpAsHex(UINT u);
CDumpContext& DumpAsHex(ULONGLONG n);
CDumpContext& DumpAsHex(WORD w);

Dönüş Değeri

Bir nesneye CDumpContext başvuru.

Açıklamalar

Belirtilen türdeki öğeyi onaltılık sayı olarak dökümünü almak için bu üye işlevini çağırın. Dizi dökümü almak için CDumpContext::HexDump çağrısında bulunur.

Örnek

#if _DEBUG
afxDump.DumpAsHex(115);
#endif

CDumpContext::Flush

Arabelleklerde kalan tüm verilerin döküm bağlamı ekli dosyaya yazılması için zorlar.

void Flush();

Örnek

#if _DEBUG
afxDump.Flush();
#endif

CDumpContext::GetDepth

Derin veya sığ bir döküm işleminin devam edip etmediğini belirler.

int GetDepth() const;

Dönüş Değeri

tarafından SetDepthayarlanan döküm derinliği.

Örnek

SetDepth örneğine bakın.

CDumpContext::HexDump

Onaltılık sayı olarak biçimlendirilmiş bir bayt dizisinin dökümünü alır.

void HexDump(
    LPCTSTR lpszLine,
    BYTE* pby,
    int nBytes,
    int nWidth);

Parametreler

lpszLine
Yeni bir satırın başında çıkış için bir dize.

pby
Dökümü yapılan baytları içeren arabelleğe yönelik bir işaretçi.

nBayt
Dökümü atacak bayt sayısı.

nWidth
Satır başına atılan bayt sayısı üst sınırı (çıkış satırının genişliği değil).

Açıklamalar

Tek, belirli bir öğe türünü onaltılık numara olarak döküm etmek için CDumpContext::D umpAsHex öğesini çağırabilirsiniz.

Örnek

#if _DEBUG
TCHAR test[] = _T("This is a test of CDumpContext::HexDump\n");
afxDump.HexDump(_T("."), (BYTE *)test, sizeof(test), 20);
#endif

CDumpContext::operator <<

Belirtilen verileri döküm bağlamını oluşturur.

CDumpContext& operator<<(const CObject* pOb);
CDumpContext& operator<<(const CObject& ob);
CDumpContext& operator<<(LPCTSTR lpsz);
CDumpContext& operator<<(const void* lp);
CDumpContext& operator<<(BYTE by);
CDumpContext& operator<<(WORD w);
CDumpContext& operator<<(DWORD dw);
CDumpContext& operator<<(int n);
CDumpContext& operator<<(double d);
CDumpContext& operator<<(float f);
CDumpContext& operator<<(LONG l);
CDumpContext& operator<<(UINT u);
CDumpContext& operator<<(LPCWSTR lpsz);
CDumpContext& operator<<(LPCSTR lpsz);
CDumpContext& operator<<(LONGLONG n);
CDumpContext& operator<<(ULONGLONG n);
CDumpContext& operator<<(HWND h);
CDumpContext& operator<<(HDC h);
CDumpContext& operator<<(HMENU h);
CDumpContext& operator<<(HACCEL h);
CDumpContext& operator<<(HFONT h);

Dönüş Değeri

Bir CDumpContext başvuru. Dönüş değerini kullanarak, tek bir kaynak kodu satırına birden çok ekleme yazabilirsiniz.

Açıklamalar

Ekleme işleci hem işaretçiler hem CObject de çoğu temel tür için aşırı yüklenir. Karakter işaretçisi, dize içeriğinin dökümünü alır; işaretçisi void yalnızca adresin onaltılık dökümünü alır. LONGLONG, 64 bit imzalı bir tamsayının dökümünü verir; ULONGLONG, 64 bit işaretsiz tamsayı dökümüyle sonuçlanır.

Sınıfınızın uygulamasında IMPLEMENT_DYNAMIC veya IMPLEMENT_SERIAL makro kullanırsanız, aracılığıyla ekleme işleci CObject::Dumptüretilmiş sınıfınızın CObjectadını yazdırır. Aksi takdirde, yazdırır CObject. Sınıfının işlevini geçersiz kılarsanız Dump , nesnenin içeriğinin onaltılık döküm yerine daha anlamlı bir çıkışını sağlayabilirsiniz.

Örnek

#if _DEBUG
CStringList li;
li.AddHead(_T("item 0"));
li.AddHead(_T("item 1"));
CString s = _T("test");
int i = 7;
long lo = 1000000000L;
LONGLONG lolo = 12345678901234i64;
afxDump << _T("list=") << &li << _T("string=")
        << s << _T("int=") << i << _T("long=") << lo
        << _T("LONGLONG=") << lolo << _T("\n");
#endif

CDumpContext::SetDepth

Döküm derinliğini ayarlar.

void SetDepth(int nNewDepth);

Parametreler

nNewDepth
Yeni derinlik değeri.

Açıklamalar

Diğer nesnelere işaretçi içermeyen ilkel veya basit CObject bir tür dökümü kullanıyorsanız, 0 değeri yeterlidir. 0'dan büyük bir değer, tüm nesnelerin özyinelemeli olarak atıldığı derin dökümü belirtir. Örneğin, bir koleksiyonun ayrıntılı dökümü koleksiyonun tüm öğelerinin dökümünü alır. Türetilmiş sınıflarınızda diğer belirli derinlik değerlerini kullanabilirsiniz.

Örnek

#if _DEBUG
afxDump.SetDepth(1); // Specifies deep dump
ASSERT(afxDump.GetDepth() == 1);
#endif

Ayrıca bkz.

Hiyerarşi Grafiği
CFile Sınıfı
CObject Sınıfı