SBValueList#

class lldb.SBValueList(*args)#

Represents a collection of SBValues. Both SBFrame.GetVariables() and SBFrame.GetRegisters() return a SBValueList.

SBValueList supports SBValue iteration. For example (from test/lldbutil.py),:

def get_registers(frame, kind):
    '''Returns the registers given the frame and the kind of registers desired.

    Returns None if there's no such kind.
    '''
    registerSet = frame.GetRegisters() # Return type of SBValueList.
    for value in registerSet:
        if kind.lower() in value.GetName().lower():
            return value

    return None

def get_GPRs(frame):
    '''Returns the general purpose registers of the frame as an SBValue.

    The returned SBValue object is iterable.  An example:
        ...
        from lldbutil import get_GPRs
        regs = get_GPRs(frame)
        for reg in regs:
            print('%s => %s' % (reg.GetName(), reg.GetValue()))
        ...
    '''
    return get_registers(frame, 'general purpose')

def get_FPRs(frame):
    '''Returns the floating point registers of the frame as an SBValue.

    The returned SBValue object is iterable.  An example:
        ...
        from lldbutil import get_FPRs
        regs = get_FPRs(frame)
        for reg in regs:
            print('%s => %s' % (reg.GetName(), reg.GetValue()))
        ...
    '''
    return get_registers(frame, 'floating point')

def get_ESRs(frame):
    '''Returns the exception state registers of the frame as an SBValue.

    The returned SBValue object is iterable.  An example:
        ...
        from lldbutil import get_ESRs
        regs = get_ESRs(frame)
        for reg in regs:
            print('%s => %s' % (reg.GetName(), reg.GetValue()))
        ...
    '''
    return get_registers(frame, 'exception state')

Methods Summary

Append()

Clear(SBValueList self)

FindValueObjectByUID(SBValueList self, lldb)

GetError(SBValueList self)

GetFirstValueByName(SBValueList self, ...)

GetSize(SBValueList self)

GetValueAtIndex(SBValueList self, uint32_t idx)

IsValid(SBValueList self)

Methods Documentation

Append(SBValueList self, SBValue val_obj)#
Append(SBValueList self, SBValueList value_list) None
Clear(SBValueList self)#
FindValueObjectByUID(SBValueList self, lldb::user_id_t uid) SBValue#
GetError(SBValueList self) SBError#
GetFirstValueByName(SBValueList self, char const * name) SBValue#
GetSize(SBValueList self) uint32_t#
GetValueAtIndex(SBValueList self, uint32_t idx) SBValue#
IsValid(SBValueList self) bool#
__iter__()#

Iterate over all values in a lldb.SBValueList object.