gimbal_stack_frame.h File Reference

Go to the source code of this file.

Data Structures
struct	GblSourceLocation
struct	GblCallRecord
struct	GblStackFrame

Functions
static void	GblCallRecord_construct (GblCallRecord *pRecord, GBL_RESULT resultCode, GblSourceLocation source, const char *pFmt,...)
static GBL_RESULT	GblStackFrame_construct (GblStackFrame *pFrame, GblObject *pObject, GBL_RESULT initialResult)

Detailed Description

Stack frame, call record, source capture debug utilities.

Author

Falco Girgis

Definition in file gimbal_stack_frame.h.

Function Documentation

GblCallRecord_construct()

static void GblCallRecord_construct ( GblCallRecord * pRecord, GBL_RESULT resultCode, GblSourceLocation source, const char * pFmt, ... )

inlinestatic

Definition at line 105 of file gimbal_stack_frame.h.

                                                                                                                                                     {
    va_list varArgs;
    va_start(varArgs, pFmt);
    pRecord->result = GBL_RESULT_UNKNOWN;
    pRecord->message[0] = '\0';
    pRecord->srcLocation.pFile = pRecord->srcLocation.pFunc = GBL_NULL;
    if GBL_UNLIKELY(pFmt) vsprintf(pRecord->message, pFmt, varArgs);
    va_end(varArgs);
    pRecord->srcLocation    = source;
    pRecord->result         = resultCode;
}

GblStackFrame_construct()

static GBL_RESULT GblStackFrame_construct ( GblStackFrame * pFrame, GblObject * pObject, GBL_RESULT initialResult )

inlinestatic

Definition at line 117 of file gimbal_stack_frame.h.

                                                                                                                                {
    GBL_RESULT result               = GBL_RESULT_SUCCESS;
    GblContext* pContext            = GBL_NULL;
 
    if GBL_UNLIKELY(pObject) {
        const GblStackFrame* pPrev = GblThd_stackFrameTop(NULL);
        if GBL_LIKELY(pPrev && pPrev->pObject == pObject) {
            pContext = pPrev->pContext;
        } else {
            pContext = GblObject_findContext(pObject);
        }
    }
 
    if GBL_LIKELY(!pContext) {
        pContext = GblThd_context(NULL);
    }
 
    pFrame->record.srcLocation.pFile    = GBL_NULL;
    pFrame->record.srcLocation.pFunc    = GBL_NULL;
    pFrame->record.result               = initialResult;
    pFrame->stackDepth                  = 0;
    pFrame->sourceCurrentCaptureDepth   = 0;
    pFrame->pObject                     = pObject;
    pFrame->pContext                    = pContext;
    pFrame->pPrevFrame                  = NULL;
    return result;
}