| """ |
| Example data formatters for strings represented as (pointer,length) pairs |
| encoded in UTF8/16/32 for use with the LLDB debugger |
| |
| To use in your projects, tweak the children names as appropriate for your data structures |
| and use as summaries for your data types |
| |
| part of The LLVM Compiler Infrastructure |
| This file is distributed under the University of Illinois Open Source |
| License. See LICENSE.TXT for details. |
| """ |
| |
| import lldb |
| def utf8_summary(value,unused): |
| pointer = value.GetChildMemberWithName("first").GetValueAsUnsigned(0) |
| length = value.GetChildMemberWithName("second").GetValueAsUnsigned(0) |
| if pointer == 0: |
| return False |
| if length == 0: |
| return '""' |
| error = lldb.SBError() |
| string_data = value.process.ReadMemory(pointer, length, error) |
| return '"%s"' % (string_data) # utf8 is safe to emit as-is on OSX |
| |
| def utf16_summary(value,unused): |
| pointer = value.GetChildMemberWithName("first").GetValueAsUnsigned(0) |
| length = value.GetChildMemberWithName("second").GetValueAsUnsigned(0) |
| # assume length is in bytes - if in UTF16 chars, just multiply by 2 |
| if pointer == 0: |
| return False |
| if length == 0: |
| return '""' |
| error = lldb.SBError() |
| string_data = value.process.ReadMemory(pointer, length, error) |
| return '"%s"' % (string_data.decode('utf-16').encode('utf-8')) # utf8 is safe to emit as-is on OSX |
| |
| def utf32_summary(value,unused): |
| pointer = value.GetChildMemberWithName("first").GetValueAsUnsigned(0) |
| length = value.GetChildMemberWithName("second").GetValueAsUnsigned(0) |
| # assume length is in bytes - if in UTF32 chars, just multiply by 4 |
| if pointer == 0: |
| return False |
| if length == 0: |
| return '""' |
| error = lldb.SBError() |
| string_data = value.process.ReadMemory(pointer, length, error) |
| return '"%s"' % (string_data.decode('utf-32').encode('utf-8')) # utf8 is safe to emit as-is on OSX |
| |
