#?Pretty-printer?utilities.
#?Copyright?（C）?2010-2013?Free?Software?Foundation?Inc.

#?This?program?is?free?software;?you?can?redistribute?it?and/or?modify
#?it?under?the?terms?of?the?GNU?General?Public?License?as?published?by
#?the?Free?Software?Foundation;?either?version?3?of?the?License?or
#?（at?your?option）?any?later?version.
#
#?This?program?is?distributed?in?the?hope?that?it?will?be?useful
#?but?WITHOUT?ANY?WARRANTY;?without?even?the?implied?warranty?of
#?MERCHANTABILITY?or?FITNESS?FOR?A?PARTICULAR?PURPOSE.??See?the
#?GNU?General?Public?License?for?more?details.
#
#?You?should?have?received?a?copy?of?the?GNU?General?Public?License
#?along?with?this?program.??If?not?see?.

“““Utilities?for?working?with?pretty-printers.“““

import?gdb
import?gdb.types
import?re
import?sys

if?sys.version_info[0]?>?2:
????#?Python?3?removed?basestring?and?long
????basestring?=?str
????long?=?int

class?PrettyPrinter（object）:
????“““A?basic?pretty-printer.

????Attributes:
????????name:?A?unique?string?among?all?printers?for?the?context?in?which
????????????it?is?defined?（objfile?progspace?or?global（gdb））?and?should
????????????meaningfully?describe?what?can?be?pretty-printed.
????????????E.g.?“StringPiece“?or?“protobufs“.
????????subprinters:?An?iterable?object?with?each?element?having?a?‘name‘
????????????attribute?and?potentially?“enabled“?attribute.
????????????Or?this?is?None?if?there?are?no?subprinters.
????????enabled:?A?boolean?indicating?if?the?printer?is?enabled.

????Subprinters?are?for?situations?where?“one“?pretty-printer?is?actually?a
????collection?of?several?printers.??E.g.?The?libstdc++?pretty-printer?has
????a?pretty-printer?for?each?of?several?different?types?based?on?regexps.
????“““

????#?While?one?might?want?to?push?subprinters?into?the?subclass?it‘s
????#?present?here?to?formalize?such?support?to?simplify
????#?commands/pretty_printers.py.

????def?__init__（self?name?subprinters=None）:
????????self.name?=?name
????????self.subprinters?=?subprinters
????????self.enabled?=?True

????def?__call__（self?val）:
????????#?The?subclass?must?define?this.
????????raise?NotImplementedError（“PrettyPrinter?__call__“）


class?SubPrettyPrinter（object）:
????“““baseclass?for?sub-pretty-printers.

????Sub-pretty-printers?needn‘t?use?this?but?it?formalizes?what‘s?needed.

????Attributes:
????????name:?The?name?of?the?subprinter.
????????enabled:?A?boolean?indicating?if?the?subprinter?is?enabled.
????“““

????def?__init__（self?name）:
????????self.name?=?name
????????self.enabled?=?True


def?register_pretty_printer（obj?printer?replace=False）:
????“““Register?pretty-printer?PRINTER?with?OBJ.

????The?printer?is?added?to?the?front?of?the?search?list?thus?one?can?override
????an?existing?printer?if?one?needs?to.??Use?a?different?name?when?overriding
????an?existing?printer?otherwise?an?exception?will?be?raised;?multiple
????printers?with?the?same?name?are?disallowed.

????Arguments:
????????obj:?Either?an?obj

?屬性????????????大小?????日期????時間???名稱
-----------?---------??----------?-----??----
?????目錄???????????0??2016-11-09?01:21??GCC\
?????目錄???????????0??2016-11-09?02:47??GCC\bin\
?????文件??????887310??2015-09-10?06:15??GCC\bin\addr2line.exe
?????文件??????913934??2015-09-10?06:15??GCC\bin\ar.exe
?????文件?????1643022??2015-09-10?06:16??GCC\bin\as.exe
?????文件??????876046??2015-09-10?06:15??GCC\bin\c++filt.exe
?????文件??????929806??2016-09-07?03:44??GCC\bin\cpp.exe
?????文件??????944654??2015-09-10?06:15??GCC\bin\dlltool.exe
?????文件??????159246??2015-09-10?06:15??GCC\bin\dllwrap.exe
?????文件??????146446??2015-09-10?06:15??GCC\bin\elfedit.exe
?????文件???????69134??2016-09-07?03:44??GCC\bin\gcc-ar.exe
?????文件???????69134??2016-09-07?03:44??GCC\bin\gcc-nm.exe
?????文件???????69134??2016-09-07?03:44??GCC\bin\gcc-ranlib.exe
?????文件??????928782??2016-09-07?03:44??GCC\bin\gcc.exe
?????文件??????552974??2016-09-07?03:44??GCC\bin\gcov-tool.exe
?????文件??????573454??2016-09-07?03:44??GCC\bin\gcov.exe
?????文件????30595068??2013-09-15?09:52??GCC\bin\gdb.exe
?????文件??????908334??2013-09-15?09:52??GCC\bin\gdbserver.exe
?????文件??????946702??2015-09-10?06:16??GCC\bin\gprof.exe
?????文件?????1206798??2015-09-10?06:16??GCC\bin\ld.bfd.exe
?????文件?????1206798??2015-09-10?06:16??GCC\bin\ld.exe
?????文件???????24310??2016-04-27?04:10??GCC\bin\libatomic-1.dll
?????文件??????149207??2013-09-01?09:38??GCC\bin\libcharset-1.dll
?????文件??????116908??2016-04-27?04:10??GCC\bin\libgcc_s_dw2-1.dll
?????文件??????684711??2013-08-22?19:45??GCC\bin\libgmp-10.dll
?????文件???????78576??2013-08-22?19:45??GCC\bin\libgmpxx-4.dll
?????文件??????128948??2016-04-27?04:10??GCC\bin\libgomp-1.dll
?????文件?????1408750??2013-09-01?09:39??GCC\bin\libiconv-2.dll
?????文件??????484613??2014-04-30?20:33??GCC\bin\libintl-8.dll
?????文件??????108891??2015-08-20?05:49??GCC\bin\libmpc-3.dll
?????文件??????486503??2013-09-25?08:50??GCC\bin\libmpfr-4.dll
............此處省略995個文件信息