/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / python / pytexdoc / ext / lib / lib1 / traceback / tex

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 53 74 61 6e 64 61 72 |\section|{Standar|
|00000010| 64 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |d Module| \sectco|
|00000020| 64 65 7b 74 72 61 63 65 | 62 61 63 6b 7d 7d 0a 5c |de{trace|back}}.\|
|00000030| 73 74 6d 6f 64 69 6e 64 | 65 78 7b 74 72 61 63 65 |stmodind|ex{trace|
|00000040| 62 61 63 6b 7d 0a 0a 5c | 72 65 6e 65 77 63 6f 6d |back}..\|renewcom|
|00000050| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000060| 65 6d 7d 7b 28 69 6e 20 | 6d 6f 64 75 6c 65 20 74 |em}{(in |module t|
|00000070| 72 61 63 65 62 61 63 6b | 29 7d 0a 0a 54 68 69 73 |raceback|)}..This|
|00000080| 20 6d 6f 64 75 6c 65 20 | 70 72 6f 76 69 64 65 73 | module |provides|
|00000090| 20 61 20 73 74 61 6e 64 | 61 72 64 20 69 6e 74 65 | a stand|ard inte|
|000000a0| 72 66 61 63 65 20 74 6f | 20 66 6f 72 6d 61 74 20 |rface to| format |
|000000b0| 61 6e 64 20 70 72 69 6e | 74 20 73 74 61 63 6b 0a |and prin|t stack.|
|000000c0| 74 72 61 63 65 73 20 6f | 66 20 50 79 74 68 6f 6e |traces o|f Python|
|000000d0| 20 70 72 6f 67 72 61 6d | 73 2e 20 20 49 74 20 65 | program|s.  It e|
|000000e0| 78 61 63 74 6c 79 20 6d | 69 6d 69 63 73 20 74 68 |xactly m|imics th|
|000000f0| 65 20 62 65 68 61 76 69 | 6f 72 20 6f 66 20 74 68 |e behavi|or of th|
|00000100| 65 0a 50 79 74 68 6f 6e | 20 69 6e 74 65 72 70 72 |e.Python| interpr|
|00000110| 65 74 65 72 20 77 68 65 | 6e 20 69 74 20 70 72 69 |eter whe|n it pri|
|00000120| 6e 74 73 20 61 20 73 74 | 61 63 6b 20 74 72 61 63 |nts a st|ack trac|
|00000130| 65 2e 20 20 54 68 69 73 | 20 69 73 20 75 73 65 66 |e.  This| is usef|
|00000140| 75 6c 20 77 68 65 6e 0a | 79 6f 75 20 77 61 6e 74 |ul when.|you want|
|00000150| 20 74 6f 20 70 72 69 6e | 74 20 73 74 61 63 6b 20 | to prin|t stack |
|00000160| 74 72 61 63 65 73 20 75 | 6e 64 65 72 20 70 72 6f |traces u|nder pro|
|00000170| 67 72 61 6d 20 63 6f 6e | 74 72 6f 6c 2c 20 65 2e |gram con|trol, e.|
|00000180| 67 2e 20 69 6e 20 61 0a | 60 60 77 72 61 70 70 65 |g. in a.|``wrappe|
|00000190| 72 27 27 20 61 72 6f 75 | 6e 64 20 74 68 65 20 69 |r'' arou|nd the i|
|000001a0| 6e 74 65 72 70 72 65 74 | 65 72 2e 0a 0a 54 68 65 |nterpret|er...The|
|000001b0| 20 6d 6f 64 75 6c 65 20 | 75 73 65 73 20 74 72 61 | module |uses tra|
|000001c0| 63 65 62 61 63 6b 20 6f | 62 6a 65 63 74 73 20 2d |ceback o|bjects -|
|000001d0| 2d 2d 20 74 68 69 73 20 | 69 73 20 74 68 65 20 6f |-- this |is the o|
|000001e0| 62 6a 65 63 74 20 74 79 | 70 65 0a 74 68 61 74 20 |bject ty|pe.that |
|000001f0| 69 73 20 73 74 6f 72 65 | 64 20 69 6e 20 74 68 65 |is store|d in the|
|00000200| 20 76 61 72 69 61 62 6c | 65 73 20 5c 63 6f 64 65 | variabl|es \code|
|00000210| 7b 73 79 73 2e 65 78 63 | 5f 74 72 61 63 65 62 61 |{sys.exc|_traceba|
|00000220| 63 6b 7d 20 61 6e 64 0a | 5c 63 6f 64 65 7b 73 79 |ck} and.|\code{sy|
|00000230| 73 2e 6c 61 73 74 5f 74 | 72 61 63 65 62 61 63 6b |s.last_t|raceback|
|00000240| 7d 2e 0a 0a 54 68 65 20 | 6d 6f 64 75 6c 65 20 64 |}...The |module d|
|00000250| 65 66 69 6e 65 73 20 74 | 68 65 20 66 6f 6c 6c 6f |efines t|he follo|
|00000260| 77 69 6e 67 20 66 75 6e | 63 74 69 6f 6e 73 3a 0a |wing fun|ctions:.|
|00000270| 0a 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000280| 7d 7b 70 72 69 6e 74 5f | 74 62 7d 7b 74 72 61 63 |}{print_|tb}{trac|
|00000290| 65 62 61 63 6b 5c 6f 70 | 74 69 6f 6e 61 6c 7b 5c |eback\op|tional{\|
|000002a0| 2c 20 6c 69 6d 69 74 7d | 7d 0a 50 72 69 6e 74 20 |, limit}|}.Print |
|000002b0| 75 70 20 74 6f 20 5c 76 | 61 72 7b 6c 69 6d 69 74 |up to \v|ar{limit|
|000002c0| 7d 20 73 74 61 63 6b 20 | 74 72 61 63 65 20 65 6e |} stack |trace en|
|000002d0| 74 72 69 65 73 20 66 72 | 6f 6d 20 5c 76 61 72 7b |tries fr|om \var{|
|000002e0| 74 72 61 63 65 62 61 63 | 6b 7d 2e 20 20 49 66 0a |tracebac|k}.  If.|
|000002f0| 5c 76 61 72 7b 6c 69 6d | 69 74 7d 20 69 73 20 6f |\var{lim|it} is o|
|00000300| 6d 69 74 74 65 64 20 6f | 72 20 5c 63 6f 64 65 7b |mitted o|r \code{|
|00000310| 4e 6f 6e 65 7d 2c 20 61 | 6c 6c 20 65 6e 74 72 69 |None}, a|ll entri|
|00000320| 65 73 20 61 72 65 20 70 | 72 69 6e 74 65 64 2e 0a |es are p|rinted..|
|00000330| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00000340| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000350| 7b 65 78 74 72 61 63 74 | 5f 74 62 7d 7b 74 72 61 |{extract|_tb}{tra|
|00000360| 63 65 62 61 63 6b 5c 6f | 70 74 69 6f 6e 61 6c 7b |ceback\o|ptional{|
|00000370| 5c 2c 20 6c 69 6d 69 74 | 7d 7d 0a 52 65 74 75 72 |\, limit|}}.Retur|
|00000380| 6e 20 61 20 6c 69 73 74 | 20 6f 66 20 75 70 20 74 |n a list| of up t|
|00000390| 6f 20 5c 76 61 72 7b 6c | 69 6d 69 74 7d 20 60 60 |o \var{l|imit} ``|
|000003a0| 70 72 65 2d 70 72 6f 63 | 65 73 73 65 64 27 27 20 |pre-proc|essed'' |
|000003b0| 73 74 61 63 6b 20 74 72 | 61 63 65 0a 65 6e 74 72 |stack tr|ace.entr|
|000003c0| 69 65 73 20 65 78 74 72 | 61 63 74 65 64 20 66 72 |ies extr|acted fr|
|000003d0| 6f 6d 20 5c 76 61 72 7b | 74 72 61 63 65 62 61 63 |om \var{|tracebac|
|000003e0| 6b 7d 2e 20 20 49 74 20 | 69 73 20 75 73 65 66 75 |k}.  It |is usefu|
|000003f0| 6c 20 66 6f 72 20 61 6c | 74 65 72 6e 61 74 65 0a |l for al|ternate.|
|00000400| 66 6f 72 6d 61 74 74 69 | 6e 67 20 6f 66 20 73 74 |formatti|ng of st|
|00000410| 61 63 6b 20 74 72 61 63 | 65 73 2e 20 20 49 66 20 |ack trac|es.  If |
|00000420| 5c 76 61 72 7b 6c 69 6d | 69 74 7d 20 69 73 20 6f |\var{lim|it} is o|
|00000430| 6d 69 74 74 65 64 20 6f | 72 20 5c 63 6f 64 65 7b |mitted o|r \code{|
|00000440| 4e 6f 6e 65 7d 2c 0a 61 | 6c 6c 20 65 6e 74 72 69 |None},.a|ll entri|
|00000450| 65 73 20 61 72 65 20 65 | 78 74 72 61 63 74 65 64 |es are e|xtracted|
|00000460| 2e 20 20 41 20 60 60 70 | 72 65 2d 70 72 6f 63 65 |.  A ``p|re-proce|
|00000470| 73 73 65 64 27 27 20 73 | 74 61 63 6b 20 74 72 61 |ssed'' s|tack tra|
|00000480| 63 65 20 65 6e 74 72 79 | 20 69 73 20 61 0a 71 75 |ce entry| is a.qu|
|00000490| 61 64 72 75 70 6c 65 20 | 28 5c 76 61 72 7b 66 69 |adruple |(\var{fi|
|000004a0| 6c 65 6e 61 6d 65 7d 2c | 20 5c 76 61 72 7b 6c 69 |lename},| \var{li|
|000004b0| 6e 65 20 6e 75 6d 62 65 | 72 7d 2c 20 5c 76 61 72 |ne numbe|r}, \var|
|000004c0| 7b 66 75 6e 63 74 69 6f | 6e 20 6e 61 6d 65 7d 2c |{functio|n name},|
|000004d0| 0a 5c 76 61 72 7b 6c 69 | 6e 65 20 74 65 78 74 7d |.\var{li|ne text}|
|000004e0| 29 20 72 65 70 72 65 73 | 65 6e 74 69 6e 67 20 74 |) repres|enting t|
|000004f0| 68 65 20 69 6e 66 6f 72 | 6d 61 74 69 6f 6e 20 74 |he infor|mation t|
|00000500| 68 61 74 20 69 73 20 75 | 73 75 61 6c 6c 79 20 70 |hat is u|sually p|
|00000510| 72 69 6e 74 65 64 0a 66 | 6f 72 20 61 20 73 74 61 |rinted.f|or a sta|
|00000520| 63 6b 20 74 72 61 63 65 | 2e 20 20 54 68 65 20 5c |ck trace|.  The \|
|00000530| 76 61 72 7b 6c 69 6e 65 | 20 74 65 78 74 7d 20 69 |var{line| text} i|
|00000540| 73 20 61 20 73 74 72 69 | 6e 67 20 77 69 74 68 20 |s a stri|ng with |
|00000550| 6c 65 61 64 69 6e 67 20 | 61 6e 64 0a 74 72 61 69 |leading |and.trai|
|00000560| 6c 69 6e 67 20 77 68 69 | 74 65 73 70 61 63 65 20 |ling whi|tespace |
|00000570| 73 74 72 69 70 70 65 64 | 3b 20 69 66 20 74 68 65 |stripped|; if the|
|00000580| 20 73 6f 75 72 63 65 20 | 69 73 20 6e 6f 74 20 61 | source |is not a|
|00000590| 76 61 69 6c 61 62 6c 65 | 20 69 74 20 69 73 0a 5c |vailable| it is.\|
|000005a0| 63 6f 64 65 7b 4e 6f 6e | 65 7d 2e 0a 5c 65 6e 64 |code{Non|e}..\end|
|000005b0| 7b 66 75 6e 63 64 65 73 | 63 7d 0a 0a 5c 62 65 67 |{funcdes|c}..\beg|
|000005c0| 69 6e 7b 66 75 6e 63 64 | 65 73 63 7d 7b 70 72 69 |in{funcd|esc}{pri|
|000005d0| 6e 74 5f 65 78 63 65 70 | 74 69 6f 6e 7d 7b 74 79 |nt_excep|tion}{ty|
|000005e0| 70 65 5c 2c 20 76 61 6c | 75 65 5c 2c 20 74 72 61 |pe\, val|ue\, tra|
|000005f0| 63 65 62 61 63 6b 5c 6f | 70 74 69 6f 6e 61 6c 7b |ceback\o|ptional{|
|00000600| 5c 2c 20 6c 69 6d 69 74 | 7d 7d 0a 50 72 69 6e 74 |\, limit|}}.Print|
|00000610| 20 65 78 63 65 70 74 69 | 6f 6e 20 69 6e 66 6f 72 | excepti|on infor|
|00000620| 6d 61 74 69 6f 6e 20 61 | 6e 64 20 75 70 20 74 6f |mation a|nd up to|
|00000630| 20 5c 76 61 72 7b 6c 69 | 6d 69 74 7d 20 73 74 61 | \var{li|mit} sta|
|00000640| 63 6b 20 74 72 61 63 65 | 20 65 6e 74 72 69 65 73 |ck trace| entries|
|00000650| 0a 66 72 6f 6d 20 5c 76 | 61 72 7b 74 72 61 63 65 |.from \v|ar{trace|
|00000660| 62 61 63 6b 7d 2e 20 20 | 54 68 69 73 20 64 69 66 |back}.  |This dif|
|00000670| 66 65 72 73 20 66 72 6f | 6d 20 5c 63 6f 64 65 7b |fers fro|m \code{|
|00000680| 70 72 69 6e 74 5f 74 62 | 7d 20 69 6e 20 74 68 65 |print_tb|} in the|
|00000690| 0a 66 6f 6c 6c 6f 77 69 | 6e 67 20 77 61 79 73 3a |.followi|ng ways:|
|000006a0| 20 28 31 29 20 69 66 20 | 5c 76 61 72 7b 74 72 61 | (1) if |\var{tra|
|000006b0| 63 65 62 61 63 6b 7d 20 | 69 73 20 6e 6f 74 20 5c |ceback} |is not \|
|000006c0| 63 6f 64 65 7b 4e 6f 6e | 65 7d 2c 20 69 74 20 70 |code{Non|e}, it p|
|000006d0| 72 69 6e 74 73 20 61 0a | 68 65 61 64 65 72 20 60 |rints a.|header `|
|000006e0| 60 5c 63 6f 64 65 7b 54 | 72 61 63 65 62 61 63 6b |`\code{T|raceback|
|000006f0| 20 28 69 6e 6e 65 72 6d | 6f 73 74 20 6c 61 73 74 | (innerm|ost last|
|00000700| 29 3a 7d 27 27 3b 20 28 | 32 29 20 69 74 20 70 72 |):}''; (|2) it pr|
|00000710| 69 6e 74 73 20 74 68 65 | 0a 65 78 63 65 70 74 69 |ints the|.excepti|
|00000720| 6f 6e 20 5c 76 61 72 7b | 74 79 70 65 7d 20 61 6e |on \var{|type} an|
|00000730| 64 20 5c 76 61 72 7b 76 | 61 6c 75 65 7d 20 61 66 |d \var{v|alue} af|
|00000740| 74 65 72 20 74 68 65 20 | 73 74 61 63 6b 20 74 72 |ter the |stack tr|
|00000750| 61 63 65 3b 20 28 33 29 | 20 69 66 0a 5c 76 61 72 |ace; (3)| if.\var|
|00000760| 7b 74 79 70 65 7d 20 69 | 73 20 5c 63 6f 64 65 7b |{type} i|s \code{|
|00000770| 53 79 6e 74 61 78 45 72 | 72 6f 72 7d 20 61 6e 64 |SyntaxEr|ror} and|
|00000780| 20 5c 76 61 72 7b 76 61 | 6c 75 65 7d 20 68 61 73 | \var{va|lue} has|
|00000790| 20 74 68 65 20 61 70 70 | 72 6f 70 72 69 61 74 65 | the app|ropriate|
|000007a0| 0a 66 6f 72 6d 61 74 2c | 20 69 74 20 70 72 69 6e |.format,| it prin|
|000007b0| 74 73 20 74 68 65 20 6c | 69 6e 65 20 77 68 65 72 |ts the l|ine wher|
|000007c0| 65 20 74 68 65 20 73 79 | 6e 74 61 78 20 65 72 72 |e the sy|ntax err|
|000007d0| 6f 72 20 6f 63 63 75 72 | 72 65 64 20 77 69 74 68 |or occur|red with|
|000007e0| 20 61 0a 63 61 72 65 74 | 20 69 6e 64 69 63 61 74 | a.caret| indicat|
|000007f0| 69 6f 6e 20 74 68 65 20 | 61 70 70 72 6f 78 69 6d |ion the |approxim|
|00000800| 61 74 65 20 70 6f 73 69 | 74 69 6f 6e 20 6f 66 20 |ate posi|tion of |
|00000810| 74 68 65 20 65 72 72 6f | 72 2e 0a 5c 65 6e 64 7b |the erro|r..\end{|
|00000820| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |funcdesc|}..\begi|
|00000830| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 70 72 69 6e |n{funcde|sc}{prin|
|00000840| 74 5f 65 78 63 7d 7b 5c | 6f 70 74 69 6f 6e 61 6c |t_exc}{\|optional|
|00000850| 7b 6c 69 6d 69 74 7d 7d | 0a 54 68 69 73 20 69 73 |{limit}}|.This is|
|00000860| 20 61 20 73 68 6f 72 74 | 68 61 6e 64 20 66 6f 72 | a short|hand for|
|00000870| 20 5c 63 6f 64 65 7b 70 | 72 69 6e 74 5f 65 78 63 | \code{p|rint_exc|
|00000880| 65 70 74 69 6f 6e 28 73 | 79 73 2e 65 78 63 5f 74 |eption(s|ys.exc_t|
|00000890| 79 70 65 2c 7d 0a 5c 63 | 6f 64 65 7b 73 79 73 2e |ype,}.\c|ode{sys.|
|000008a0| 65 78 63 5f 76 61 6c 75 | 65 2c 7d 20 5c 63 6f 64 |exc_valu|e,} \cod|
|000008b0| 65 7b 73 79 73 2e 65 78 | 63 5f 74 72 61 63 65 62 |e{sys.ex|c_traceb|
|000008c0| 61 63 6b 2c 7d 20 5c 63 | 6f 64 65 7b 6c 69 6d 69 |ack,} \c|ode{limi|
|000008d0| 74 29 7d 2e 0a 5c 65 6e | 64 7b 66 75 6e 63 64 65 |t)}..\en|d{funcde|
|000008e0| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000008f0| 64 65 73 63 7d 7b 70 72 | 69 6e 74 5f 6c 61 73 74 |desc}{pr|int_last|
|00000900| 7d 7b 5c 6f 70 74 69 6f | 6e 61 6c 7b 6c 69 6d 69 |}{\optio|nal{limi|
|00000910| 74 7d 7d 0a 54 68 69 73 | 20 69 73 20 61 20 73 68 |t}}.This| is a sh|
|00000920| 6f 72 74 68 61 6e 64 20 | 66 6f 72 20 5c 63 6f 64 |orthand |for \cod|
|00000930| 65 7b 70 72 69 6e 74 5f | 65 78 63 65 70 74 69 6f |e{print_|exceptio|
|00000940| 6e 28 73 79 73 2e 6c 61 | 73 74 5f 74 79 70 65 2c |n(sys.la|st_type,|
|00000950| 7d 0a 5c 63 6f 64 65 7b | 73 79 73 2e 6c 61 73 74 |}.\code{|sys.last|
|00000960| 5f 76 61 6c 75 65 2c 7d | 20 5c 63 6f 64 65 7b 73 |_value,}| \code{s|
|00000970| 79 73 2e 6c 61 73 74 5f | 74 72 61 63 65 62 61 63 |ys.last_|tracebac|
|00000980| 6b 2c 7d 20 5c 63 6f 64 | 65 7b 6c 69 6d 69 74 29 |k,} \cod|e{limit)|
|00000990| 7d 2e 0a 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |}..\end{|funcdesc|
|000009a0| 7d 0a                   |                         |}.      |        |
+--------+-------------------------+-------------------------+--------+--------+