Attachment "patch-a09031e288-quickfix.diff-c50-w" to
ticket [a09031e288]
added by
leon
2018-12-10 20:21:09.
0000: 49 6e 64 65 78 3a 20 67 65 6e 65 72 69 63 2f 74 Index: generic/t
0010: 63 6c 4f 62 6a 2e 63 0a 3d 3d 3d 3d 3d 3d 3d 3d clObj.c.========
0020: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0030: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0040: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0050: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 2d 2d 2d 20 67 ==========.--- g
0060: 65 6e 65 72 69 63 2f 74 63 6c 4f 62 6a 2e 63 0a eneric/tclObj.c.
0070: 2b 2b 2b 20 67 65 6e 65 72 69 63 2f 74 63 6c 4f +++ generic/tclO
0080: 62 6a 2e 63 0a 40 40 20 2d 35 31 2c 31 30 31 20 bj.c.@@ -51,101
0090: 2b 35 31 2c 31 30 31 20 40 40 0a 20 0a 20 63 68 +51,101 @@. . ch
00a0: 61 72 20 74 63 6c 45 6d 70 74 79 53 74 72 69 6e ar tclEmptyStrin
00b0: 67 20 3d 20 27 5c 30 27 3b 0a 20 0a 20 23 69 66 g = '\0';. . #if
00c0: 20 54 43 4c 5f 54 48 52 45 41 44 53 20 26 26 20 TCL_THREADS &&
00d0: 64 65 66 69 6e 65 64 28 54 43 4c 5f 4d 45 4d 5f defined(TCL_MEM_
00e0: 44 45 42 55 47 29 0a 20 2f 2a 0a 20 20 2a 20 53 DEBUG). /*. * S
00f0: 74 72 75 63 74 75 72 65 20 66 6f 72 20 74 72 61 tructure for tra
0100: 63 6b 69 6e 67 20 74 68 65 20 73 6f 75 72 63 65 cking the source
0110: 20 66 69 6c 65 20 61 6e 64 20 6c 69 6e 65 20 6e file and line n
0120: 75 6d 62 65 72 20 77 68 65 72 65 20 61 20 67 69 umber where a gi
0130: 76 65 6e 0a 20 20 2a 20 54 63 6c 5f 4f 62 6a 20 ven. * Tcl_Obj
0140: 77 61 73 20 61 6c 6c 6f 63 61 74 65 64 2e 20 20 was allocated.
0150: 57 65 20 61 6c 73 6f 20 74 72 61 63 6b 20 74 68 We also track th
0160: 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 e pointer to the
0170: 20 54 63 6c 5f 4f 62 6a 20 69 74 73 65 6c 66 2c Tcl_Obj itself,
0180: 0a 20 20 2a 20 66 6f 72 20 73 61 6e 69 74 79 20 . * for sanity
0190: 63 68 65 63 6b 69 6e 67 20 70 75 72 70 6f 73 65 checking purpose
01a0: 73 2e 0a 20 20 2a 2f 0a 20 0a 20 74 79 70 65 64 s.. */. . typed
01b0: 65 66 20 73 74 72 75 63 74 20 7b 0a 20 20 20 20 ef struct {.
01c0: 20 54 63 6c 5f 4f 62 6a 20 2a 6f 62 6a 50 74 72 Tcl_Obj *objPtr
01d0: 3b 09 09 2f 2a 20 54 68 65 20 70 6f 69 6e 74 65 ;../* The pointe
01e0: 72 20 74 6f 20 74 68 65 20 61 6c 6c 6f 63 61 74 r to the allocat
01f0: 65 64 20 54 63 6c 5f 4f 62 6a 2e 20 2a 2f 0a 20 ed Tcl_Obj. */.
0200: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a const char *
0210: 66 69 6c 65 3b 09 09 2f 2a 20 54 68 65 20 6e 61 file;../* The na
0220: 6d 65 20 6f 66 20 74 68 65 20 73 6f 75 72 63 65 me of the source
0230: 20 66 69 6c 65 20 63 61 6c 6c 69 6e 67 20 74 68 file calling th
0240: 69 73 0a 20 09 09 09 09 20 2a 20 66 75 6e 63 74 is. .... * funct
0250: 69 6f 6e 3b 20 75 73 65 64 20 66 6f 72 20 64 65 ion; used for de
0260: 62 75 67 67 69 6e 67 2e 20 2a 2f 0a 20 20 20 20 bugging. */.
0270: 20 69 6e 74 20 6c 69 6e 65 3b 09 09 09 2f 2a 20 int line;.../*
0280: 4c 69 6e 65 20 6e 75 6d 62 65 72 20 69 6e 20 74 Line number in t
0290: 68 65 20 73 6f 75 72 63 65 20 66 69 6c 65 3b 20 he source file;
02a0: 75 73 65 64 20 66 6f 72 0a 20 09 09 09 09 20 2a used for. .... *
02b0: 20 64 65 62 75 67 67 69 6e 67 2e 20 2a 2f 0a 20 debugging. */.
02c0: 7d 20 4f 62 6a 44 61 74 61 3b 0a 20 23 65 6e 64 } ObjData;. #end
02d0: 69 66 20 2f 2a 20 54 43 4c 5f 4d 45 4d 5f 44 45 if /* TCL_MEM_DE
02e0: 42 55 47 20 26 26 20 54 43 4c 5f 54 48 52 45 41 BUG && TCL_THREA
02f0: 44 53 20 2a 2f 0a 20 0c 0a 20 2f 2a 0a 20 20 2a DS */. .. /*. *
0300: 20 41 6c 6c 20 73 74 61 74 69 63 20 76 61 72 69 All static vari
0310: 61 62 6c 65 73 20 75 73 65 64 20 69 6e 20 74 68 ables used in th
0320: 69 73 20 66 69 6c 65 20 61 72 65 20 63 6f 6c 6c is file are coll
0330: 65 63 74 65 64 20 69 6e 74 6f 20 61 20 73 69 6e ected into a sin
0340: 67 6c 65 20 69 6e 73 74 61 6e 63 65 0a 20 20 2a gle instance. *
0350: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
0360: 67 20 73 74 72 75 63 74 75 72 65 2e 20 20 46 6f g structure. Fo
0370: 72 20 6d 75 6c 74 69 2d 74 68 72 65 61 64 65 64 r multi-threaded
0380: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 73 implementations
0390: 2c 20 74 68 65 72 65 20 69 73 0a 20 20 2a 20 6f , there is. * o
03a0: 6e 65 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74 ne instance of t
03b0: 68 69 73 20 73 74 72 75 63 74 75 72 65 20 66 6f his structure fo
03c0: 72 20 65 61 63 68 20 74 68 72 65 61 64 2e 0a 20 r each thread..
03d0: 20 2a 0a 20 20 2a 20 4e 6f 74 69 63 65 20 74 68 *. * Notice th
03e0: 61 74 20 64 69 66 66 65 72 65 6e 74 20 73 74 72 at different str
03f0: 75 63 74 75 72 65 73 20 77 69 74 68 20 74 68 65 uctures with the
0400: 20 73 61 6d 65 20 6e 61 6d 65 20 61 70 70 65 61 same name appea
0410: 72 20 69 6e 20 6f 74 68 65 72 20 66 69 6c 65 73 r in other files
0420: 2e 0a 20 20 2a 20 54 68 65 20 73 74 72 75 63 74 .. * The struct
0430: 75 72 65 20 64 65 66 69 6e 65 64 20 62 65 6c 6f ure defined belo
0440: 77 20 69 73 20 75 73 65 64 20 69 6e 20 74 68 69 w is used in thi
0450: 73 20 66 69 6c 65 20 6f 6e 6c 79 2e 0a 20 20 2a s file only.. *
0460: 2f 0a 20 0a 20 74 79 70 65 64 65 66 20 73 74 72 /. . typedef str
0470: 75 63 74 20 7b 0a 20 20 20 20 20 54 63 6c 5f 48 uct {. Tcl_H
0480: 61 73 68 54 61 62 6c 65 20 2a 6c 69 6e 65 43 4c ashTable *lineCL
0490: 50 74 72 3b 20 20 20 2f 2a 20 54 68 69 73 20 74 Ptr; /* This t
04a0: 61 62 6c 65 20 72 65 6d 65 6d 62 65 72 73 20 66 able remembers f
04b0: 6f 72 20 65 61 63 68 20 54 63 6c 5f 4f 62 6a 0a or each Tcl_Obj.
04c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
04e0: 20 20 2a 20 67 65 6e 65 72 61 74 65 64 20 62 79 * generated by
04f0: 20 61 20 63 61 6c 6c 20 74 6f 20 74 68 65 20 66 a call to the f
0500: 75 6e 63 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 unction.
0510: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0520: 20 20 20 20 20 20 20 20 20 20 2a 20 54 63 6c 53 * TclS
0530: 75 62 73 74 54 6f 6b 65 6e 73 28 29 20 66 72 6f ubstTokens() fro
0540: 6d 20 61 20 6c 69 74 65 72 61 6c 20 74 65 78 74 m a literal text
0550: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
0560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0570: 20 20 20 2a 20 77 68 65 72 65 20 62 73 2b 6e 6c * where bs+nl
0580: 20 73 65 71 75 65 6e 63 65 73 20 6f 63 63 75 72 sequences occur
0590: 65 64 20 69 6e 20 69 74 2c 20 69 66 0a 20 20 20 ed in it, if.
05a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
05b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
05c0: 20 61 6e 79 2e 20 49 2e 65 2e 20 74 68 69 73 20 any. I.e. this
05d0: 74 61 62 6c 65 20 6b 65 65 70 73 20 74 72 61 63 table keeps trac
05e0: 6b 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 20 k of.
05f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0600: 20 20 20 20 20 20 20 2a 20 69 6e 76 69 73 69 62 * invisib
0610: 6c 65 20 61 6e 64 20 73 74 72 69 70 70 65 64 20 le and stripped
0620: 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e continuation lin
0630: 65 73 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 es..
0640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0650: 20 20 20 20 20 20 2a 20 49 74 73 20 6b 65 79 73 * Its keys
0660: 20 61 72 65 20 54 63 6c 5f 4f 62 6a 20 70 6f 69 are Tcl_Obj poi
0670: 6e 74 65 72 73 2c 20 74 68 65 20 76 61 6c 75 65 nters, the value
0680: 73 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s.
0690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
06a0: 20 20 20 20 2a 20 61 72 65 20 43 6f 6e 74 4c 69 * are ContLi
06b0: 6e 65 4c 6f 63 20 70 6f 69 6e 74 65 72 73 2e 20 neLoc pointers.
06c0: 53 65 65 20 74 68 65 20 66 69 6c 65 0a 20 20 20 See the file.
06d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
06e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
06f0: 20 74 63 6c 43 6f 6d 70 69 6c 65 2e 68 20 66 6f tclCompile.h fo
0700: 72 20 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e r the definition
0710: 20 6f 66 20 74 68 69 73 0a 20 20 20 20 20 20 20 of this.
0720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0730: 20 20 20 20 20 20 20 20 20 20 20 2a 20 73 74 72 * str
0740: 75 63 74 75 72 65 2c 20 61 6e 64 20 66 6f 72 20 ucture, and for
0750: 72 65 66 65 72 65 6e 63 65 73 20 74 6f 20 61 6c references to al
0760: 6c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 l.
0770: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0780: 20 20 20 20 2a 20 72 65 6c 61 74 65 64 20 70 6c * related pl
0790: 61 63 65 73 20 69 6e 20 74 68 65 20 63 6f 72 65 aces in the core
07a0: 2e 20 2a 2f 0a 20 23 69 66 20 54 43 4c 5f 54 48 . */. #if TCL_TH
07b0: 52 45 41 44 53 20 26 26 20 64 65 66 69 6e 65 64 READS && defined
07c0: 28 54 43 4c 5f 4d 45 4d 5f 44 45 42 55 47 29 0a (TCL_MEM_DEBUG).
07d0: 20 20 20 20 20 54 63 6c 5f 48 61 73 68 54 61 62 Tcl_HashTab
07e0: 6c 65 20 2a 6f 62 6a 54 68 72 65 61 64 4d 61 70 le *objThreadMap
07f0: 3b 2f 2a 20 54 68 72 65 61 64 20 6c 6f 63 61 6c ;/* Thread local
0800: 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20 75 table that is u
0810: 73 65 64 20 74 6f 20 63 68 65 63 6b 0a 20 20 20 sed to check.
0820: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0830: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
0840: 20 74 68 61 74 20 61 20 54 63 6c 5f 4f 62 6a 20 that a Tcl_Obj
0850: 77 61 73 20 6e 6f 74 20 61 6c 6c 6f 63 61 74 65 was not allocate
0860: 64 20 62 79 20 73 6f 6d 65 0a 20 20 20 20 20 20 d by some.
0870: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
0880: 20 20 20 20 20 20 20 20 20 20 20 20 2a 20 6f 74 * ot
0890: 68 65 72 20 74 68 72 65 61 64 2e 20 2a 2f 0a 20 her thread. */.
08a0: 23 65 6e 64 69 66 20 2f 2a 20 54 43 4c 5f 4d 45 #endif /* TCL_ME
08b0: 4d 5f 44 45 42 55 47 20 26 26 20 54 43 4c 5f 54 M_DEBUG && TCL_T
08c0: 48 52 45 41 44 53 20 2a 2f 0a 20 7d 20 54 68 72 HREADS */. } Thr
08d0: 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 3b eadSpecificData;
08e0: 0a 20 0a 20 73 74 61 74 69 63 20 54 63 6c 5f 54 . . static Tcl_T
08f0: 68 72 65 61 64 44 61 74 61 4b 65 79 20 64 61 74 hreadDataKey dat
0900: 61 4b 65 79 3b 0a 20 0a 20 73 74 61 74 69 63 20 aKey;. . static
0910: 76 6f 69 64 20 20 20 20 20 20 20 20 20 20 20 20 void
0920: 20 54 63 6c 54 68 72 65 61 64 46 69 6e 61 6c 69 TclThreadFinali
0930: 7a 65 43 6f 6e 74 4c 69 6e 65 73 28 43 6c 69 65 zeContLines(Clie
0940: 6e 74 44 61 74 61 20 63 6c 69 65 6e 74 44 61 74 ntData clientDat
0950: 61 29 3b 0a 2d 73 74 61 74 69 63 20 54 68 72 65 a);.-static Thre
0960: 61 64 53 70 65 63 69 66 69 63 44 61 74 61 20 2a adSpecificData *
0970: 54 63 6c 47 65 74 43 6f 6e 74 4c 69 6e 65 54 61 TclGetContLineTa
0980: 62 6c 65 28 76 6f 69 64 29 3b 0a 2b 73 74 61 74 ble(void);.+stat
0990: 69 63 20 54 63 6c 5f 48 61 73 68 54 61 62 6c 65 ic Tcl_HashTable
09a0: 20 20 20 20 2a 54 63 6c 47 65 74 43 6f 6e 74 4c *TclGetContL
09b0: 69 6e 65 54 61 62 6c 65 28 76 6f 69 64 29 3b 0a ineTable(void);.
09c0: 20 0a 20 2f 2a 0a 20 20 2a 20 4e 65 73 74 65 64 . /*. * Nested
09d0: 20 54 63 6c 5f 4f 62 6a 20 64 65 6c 65 74 69 6f Tcl_Obj deletio
09e0: 6e 20 6d 61 6e 61 67 65 6d 65 6e 74 20 73 75 70 n management sup
09f0: 70 6f 72 74 0a 20 20 2a 0a 20 20 2a 20 41 6c 6c port. *. * All
0a00: 20 63 6f 6e 74 65 78 74 20 72 65 66 65 72 65 6e context referen
0a10: 63 65 73 20 75 73 65 64 20 69 6e 20 74 68 65 20 ces used in the
0a20: 6f 62 6a 65 63 74 20 66 72 65 65 69 6e 67 20 63 object freeing c
0a30: 6f 64 65 20 61 72 65 20 70 6f 69 6e 74 65 72 73 ode are pointers
0a40: 20 74 6f 20 74 68 69 73 0a 20 20 2a 20 73 74 72 to this. * str
0a50: 75 63 74 75 72 65 3b 20 65 76 65 72 79 20 74 68 ucture; every th
0a60: 72 65 61 64 20 77 69 6c 6c 20 68 61 76 65 20 69 read will have i
0a70: 74 73 20 6f 77 6e 20 73 74 72 75 63 74 75 72 65 ts own structure
0a80: 20 69 6e 73 74 61 6e 63 65 2e 20 54 68 65 20 70 instance. The p
0a90: 75 72 70 6f 73 65 0a 20 20 2a 20 6f 66 20 74 68 urpose. * of th
0aa0: 69 73 20 73 74 72 75 63 74 75 72 65 20 69 73 20 is structure is
0ab0: 74 6f 20 61 6c 6c 6f 77 20 64 65 65 70 6c 79 20 to allow deeply
0ac0: 6e 65 73 74 65 64 20 63 6f 6c 6c 65 63 74 69 6f nested collectio
0ad0: 6e 73 20 6f 66 20 54 63 6c 5f 4f 62 6a 73 20 74 ns of Tcl_Objs t
0ae0: 6f 20 62 65 0a 20 20 2a 20 66 72 65 65 64 20 77 o be. * freed w
0af0: 69 74 68 6f 75 74 20 74 61 6b 69 6e 67 20 61 20 ithout taking a
0b00: 76 61 73 74 20 64 65 70 74 68 20 6f 66 20 43 20 vast depth of C
0b10: 73 74 61 63 6b 20 28 77 68 69 63 68 20 63 6f 75 stack (which cou
0b20: 6c 64 20 63 61 75 73 65 20 61 6c 6c 20 73 6f 72 ld cause all sor
0b30: 74 73 0a 20 20 2a 20 6f 66 20 62 72 65 61 6b 61 ts. * of breaka
0b40: 67 65 2e 29 0a 20 20 2a 2f 0a 20 0a 20 74 79 70 ge.). */. . typ
0b50: 65 64 65 66 20 73 74 72 75 63 74 20 50 65 6e 64 edef struct Pend
0b60: 69 6e 67 4f 62 6a 44 61 74 61 20 7b 0a 20 20 20 ingObjData {.
0b70: 20 20 69 6e 74 20 64 65 6c 65 74 69 6f 6e 43 6f int deletionCo
0b80: 75 6e 74 3b 09 09 2f 2a 20 43 6f 75 6e 74 20 6f unt;../* Count o
0b90: 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 f the number of
0ba0: 69 6e 76 6f 6b 61 74 69 6f 6e 73 20 6f 66 0a 20 invokations of.
0bb0: 09 09 09 09 20 2a 20 54 63 6c 46 72 65 65 4f 62 .... * TclFreeOb
0bc0: 6a 28 29 20 61 72 65 20 6f 6e 20 74 68 65 20 73 j() are on the s
0bd0: 74 61 63 6b 20 28 61 74 20 6c 65 61 73 74 0a 20 tack (at least.
0be0: 09 09 09 09 20 2a 20 63 6f 6e 63 65 70 74 75 61 .... * conceptua
0bf0: 6c 6c 79 3b 20 6d 61 6e 79 20 61 72 65 20 61 63 lly; many are ac
0c00: 74 75 61 6c 6c 79 20 65 78 70 61 6e 64 65 64 0a tually expanded.
0c10: 20 09 09 09 09 20 2a 20 6d 61 63 72 6f 73 29 2e .... * macros).
0c20: 20 2a 2f 0a 20 20 20 20 20 54 63 6c 5f 4f 62 6a */. Tcl_Obj
0c30: 20 2a 64 65 6c 65 74 69 6f 6e 53 74 61 63 6b 3b *deletionStack;
0c40: 09 2f 2a 20 53 74 61 63 6b 20 6f 66 20 6f 62 6a ./* Stack of obj
0c50: 65 63 74 73 20 74 68 61 74 20 68 61 76 65 20 68 ects that have h
0c60: 61 64 20 54 63 6c 46 72 65 65 4f 62 6a 28 29 0a ad TclFreeObj().
0c70: 20 09 09 09 09 20 2a 20 69 6e 76 6f 6b 65 64 20 .... * invoked
0c80: 75 70 6f 6e 20 74 68 65 6d 20 62 75 74 20 77 68 upon them but wh
0c90: 69 63 68 20 63 61 6e 27 74 20 62 65 0a 20 09 09 ich can't be. ..
0ca0: 09 09 20 2a 20 64 65 6c 65 74 65 64 20 79 65 74 .. * deleted yet
0cb0: 20 62 65 63 61 75 73 65 20 74 68 65 79 20 61 72 because they ar
0cc0: 65 20 69 6e 20 61 20 6e 65 73 74 65 64 0a 20 09 e in a nested. .
0cd0: 09 09 09 20 2a 20 69 6e 76 6f 6b 61 74 69 6f 6e ... * invokation
0ce0: 20 6f 66 20 54 63 6c 46 72 65 65 4f 62 6a 28 29 of TclFreeObj()
0cf0: 2e 20 42 79 20 70 6f 73 74 70 6f 6e 69 6e 67 0a . By postponing.
0d00: 20 09 09 09 09 20 2a 20 74 68 69 73 20 77 61 79 .... * this way
0d10: 2c 20 77 65 20 6c 69 6d 69 74 20 74 68 65 20 6d , we limit the m
0d20: 61 78 69 6d 75 6d 20 6f 76 65 72 61 6c 6c 20 43 aximum overall C
0d30: 0a 20 09 09 09 09 20 2a 20 73 74 61 63 6b 20 64 . .... * stack d
0d40: 65 70 74 68 20 77 68 65 6e 20 64 65 6c 65 74 69 epth when deleti
0d50: 6e 67 20 61 20 63 6f 6d 70 6c 65 78 20 6f 62 6a ng a complex obj
0d60: 65 63 74 2e 0a 20 09 09 09 09 20 2a 20 54 68 65 ect.. .... * The
0d70: 20 64 6f 77 6e 2d 73 69 64 65 20 69 73 20 74 68 down-side is th
0d80: 61 74 20 77 65 20 61 6c 74 65 72 20 74 68 65 20 at we alter the
0d90: 6f 76 65 72 61 6c 6c 0a 20 09 09 09 09 20 2a 20 overall. .... *
0da0: 62 65 68 61 76 69 6f 75 72 20 62 79 20 61 6c 74 behaviour by alt
0db0: 65 72 69 6e 67 20 74 68 65 20 6f 72 64 65 72 20 ering the order
0dc0: 69 6e 20 77 68 69 63 68 0a 20 09 09 09 09 20 2a in which. .... *
0dd0: 20 6f 62 6a 65 63 74 73 20 61 72 65 20 64 65 6c objects are del
0de0: 65 74 65 64 2c 20 61 6e 64 20 77 65 20 63 68 61 eted, and we cha
0df0: 6e 67 65 20 74 68 65 0a 20 09 09 09 09 20 2a 20 nge the. .... *
0e00: 6f 72 64 65 72 20 69 6e 20 77 68 69 63 68 20 74 order in which t
0e10: 68 65 20 73 74 72 69 6e 67 20 72 65 70 20 61 6e he string rep an
0e20: 64 20 74 68 65 0a 20 09 09 09 09 20 2a 20 69 6e d the. .... * in
0e30: 74 65 72 6e 61 6c 20 72 65 70 20 6f 66 20 61 6e ternal rep of an
0e40: 20 6f 62 6a 65 63 74 20 61 72 65 20 64 65 6c 65 object are dele
0e50: 74 65 64 2e 20 4e 6f 74 65 0a 20 09 09 09 09 20 ted. Note. ....
0e60: 2a 20 74 68 61 74 20 63 6f 64 65 20 77 68 69 63 * that code whic
0e70: 68 20 61 73 73 75 6d 65 73 20 74 68 65 20 70 72 h assumes the pr
0e80: 65 76 69 6f 75 73 0a 20 09 09 09 09 20 2a 20 62 evious. .... * b
0e90: 65 68 61 76 69 6f 75 72 20 69 6e 20 65 69 74 68 ehaviour in eith
0ea0: 65 72 20 6f 66 20 74 68 65 73 65 20 72 65 73 70 er of these resp
0eb0: 65 63 74 73 20 69 73 0a 20 09 09 09 09 20 2a 20 ects is. .... *
0ec0: 75 6e 73 61 66 65 20 61 6e 79 77 61 79 3b 20 69 unsafe anyway; i
0ed0: 74 20 77 61 73 20 6e 65 76 65 72 20 64 6f 63 75 t was never docu
0ee0: 6d 65 6e 74 65 64 20 61 73 0a 20 09 09 09 09 20 mented as. ....
0ef0: 2a 20 74 6f 20 65 78 61 63 74 6c 79 20 77 68 61 * to exactly wha
0f00: 74 20 77 6f 75 6c 64 20 68 61 70 70 65 6e 20 69 t would happen i
0f10: 6e 20 74 68 65 73 65 0a 20 09 09 09 09 20 2a 20 n these. .... *
0f20: 63 61 73 65 73 2c 20 61 6e 64 20 74 68 65 20 6f cases, and the o
0f30: 76 65 72 61 6c 6c 20 63 6f 6e 74 72 61 63 74 20 verall contract
0f40: 6f 66 20 61 0a 20 09 09 09 09 20 2a 20 75 73 65 of a. .... * use
0f50: 72 2d 6c 65 76 65 6c 20 54 63 6c 5f 44 65 63 72 r-level Tcl_Decr
0f60: 52 65 66 43 6f 75 6e 74 28 29 20 69 73 20 73 74 RefCount() is st
0f70: 69 6c 6c 0a 20 09 09 09 09 20 2a 20 70 72 65 73 ill. .... * pres
0f80: 65 72 76 65 64 20 28 61 73 73 75 6d 69 6e 67 20 erved (assuming
0f90: 74 68 61 74 20 61 20 70 61 72 74 69 63 75 6c 61 that a particula
0fa0: 72 20 54 5f 44 52 43 0a 20 09 09 09 09 20 2a 20 r T_DRC. .... *
0fb0: 77 6f 75 6c 64 20 64 65 6c 65 74 65 20 61 6e 20 would delete an
0fc0: 6f 62 6a 65 63 74 20 69 73 20 6e 6f 74 20 76 65 object is not ve
0fd0: 72 79 0a 20 09 09 09 09 20 2a 20 73 61 66 65 29 ry. .... * safe)
0fe0: 2e 20 2a 2f 0a 20 7d 20 50 65 6e 64 69 6e 67 4f . */. } PendingO
0ff0: 62 6a 44 61 74 61 3b 0a 20 0a 20 2f 2a 0a 20 20 bjData;. . /*.
1000: 2a 20 54 68 65 73 65 20 61 72 65 20 73 65 70 61 * These are sepa
1010: 72 61 74 65 64 20 6f 75 74 20 73 6f 20 74 68 61 rated out so tha
1020: 74 20 73 6f 6d 65 20 73 65 6d 61 6e 74 69 63 20 t some semantic
1030: 63 6f 6e 74 65 6e 74 20 69 73 20 61 74 74 61 63 content is attac
1040: 68 65 64 0a 20 20 2a 20 74 6f 20 74 68 65 6d 2e hed. * to them.
1050: 0a 20 20 2a 2f 0a 20 23 64 65 66 69 6e 65 20 4f . */. #define O
1060: 62 6a 44 65 6c 65 74 69 6f 6e 4c 6f 63 6b 28 63 bjDeletionLock(c
1070: 6f 6e 74 65 78 74 50 74 72 29 09 28 28 63 6f 6e ontextPtr).((con
1080: 74 65 78 74 50 74 72 29 2d 3e 64 65 6c 65 74 69 textPtr)->deleti
1090: 6f 6e 43 6f 75 6e 74 2b 2b 29 0a 20 23 64 65 66 onCount++). #def
10a0: 69 6e 65 20 4f 62 6a 44 65 6c 65 74 69 6f 6e 55 ine ObjDeletionU
10b0: 6e 6c 6f 63 6b 28 63 6f 6e 74 65 78 74 50 74 72 nlock(contextPtr
10c0: 29 09 28 28 63 6f 6e 74 65 78 74 50 74 72 29 2d ).((contextPtr)-
10d0: 3e 64 65 6c 65 74 69 6f 6e 43 6f 75 6e 74 2d 2d >deletionCount--
10e0: 29 0a 20 23 64 65 66 69 6e 65 20 4f 62 6a 44 65 ). #define ObjDe
10f0: 6c 65 74 65 50 65 6e 64 69 6e 67 28 63 6f 6e 74 letePending(cont
1100: 65 78 74 50 74 72 29 09 28 28 63 6f 6e 74 65 78 extPtr).((contex
1110: 74 50 74 72 29 2d 3e 64 65 6c 65 74 69 6f 6e 43 tPtr)->deletionC
1120: 6f 75 6e 74 20 3e 20 30 29 0a 20 23 64 65 66 69 ount > 0). #defi
1130: 6e 65 20 4f 62 6a 4f 6e 53 74 61 63 6b 28 63 6f ne ObjOnStack(co
1140: 6e 74 65 78 74 50 74 72 29 09 09 28 28 63 6f 6e ntextPtr)..((con
1150: 74 65 78 74 50 74 72 29 2d 3e 64 65 6c 65 74 69 textPtr)->deleti
1160: 6f 6e 53 74 61 63 6b 20 21 3d 20 4e 55 4c 4c 29 onStack != NULL)
1170: 0a 20 23 64 65 66 69 6e 65 20 50 75 73 68 4f 62 . #define PushOb
1180: 6a 54 6f 44 65 6c 65 74 65 28 63 6f 6e 74 65 78 jToDelete(contex
1190: 74 50 74 72 2c 6f 62 6a 50 74 72 29 20 5c 0a 20 tPtr,objPtr) \.
11a0: 20 20 20 20 2f 2a 20 54 68 65 20 73 74 72 69 6e /* The strin
11b0: 67 20 72 65 70 20 69 73 20 61 6c 72 65 61 64 79 g rep is already
11c0: 20 69 6e 76 61 6c 69 64 61 74 65 64 20 73 6f 20 invalidated so
11d0: 77 65 20 63 61 6e 20 75 73 65 20 74 68 65 20 62 we can use the b
11e0: 79 74 65 73 20 76 61 6c 75 65 20 5c 0a 20 20 20 ytes value \.
11f0: 20 20 20 2a 20 66 6f 72 20 6f 75 72 20 70 6f 69 * for our poi
1200: 6e 74 65 72 20 63 68 61 69 6e 3a 20 70 75 73 68 nter chain: push
1210: 20 6f 6e 74 6f 20 74 68 65 20 68 65 61 64 20 6f onto the head o
1220: 66 20 74 68 65 20 73 74 61 63 6b 2e 20 2a 2f 20 f the stack. */
1230: 20 20 20 20 20 20 5c 0a 20 20 20 20 20 28 6f 62 \. (ob
1240: 6a 50 74 72 29 2d 3e 62 79 74 65 73 20 3d 20 28 jPtr)->bytes = (
1250: 63 68 61 72 20 2a 29 20 28 28 63 6f 6e 74 65 78 char *) ((contex
1260: 74 50 74 72 29 2d 3e 64 65 6c 65 74 69 6f 6e 53 tPtr)->deletionS
1270: 74 61 63 6b 29 3b 20 20 20 20 20 20 20 20 20 20 tack);
1280: 20 5c 0a 40 40 20 2d 34 33 35 2c 31 36 36 20 2b \.@@ -435,166 +
1290: 34 33 35 2c 32 31 32 20 40 40 0a 20 09 20 20 20 435,212 @@. .
12a0: 20 7d 0a 20 09 7d 0a 20 0a 20 09 54 63 6c 5f 44 }. .}. . .Tcl_D
12b0: 65 6c 65 74 65 48 61 73 68 54 61 62 6c 65 28 74 eleteHashTable(t
12c0: 61 62 6c 65 50 74 72 29 3b 0a 20 09 54 63 6c 5f ablePtr);. .Tcl_
12d0: 46 72 65 65 28 74 61 62 6c 65 50 74 72 29 3b 0a Free(tablePtr);.
12e0: 20 09 74 73 64 50 74 72 2d 3e 6f 62 6a 54 68 72 .tsdPtr->objThr
12f0: 65 61 64 4d 61 70 20 3d 20 4e 55 4c 4c 3b 0a 20 eadMap = NULL;.
1300: 20 20 20 20 7d 0a 20 23 65 6e 64 69 66 0a 20 7d }. #endif. }
1310: 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d 2d 2d 2d . .. /*. *-----
1320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1360: 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c 46 69 6e -. *. * TclFin
1370: 61 6c 69 7a 65 4f 62 6a 65 63 74 73 20 2d 2d 0a alizeObjects --.
1380: 20 20 2a 0a 20 20 2a 09 54 68 69 73 20 66 75 6e *. *.This fun
1390: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
13a0: 62 79 20 54 63 6c 5f 46 69 6e 61 6c 69 7a 65 20 by Tcl_Finalize
13b0: 74 6f 20 63 6c 65 61 6e 20 75 70 20 61 6c 6c 20 to clean up all
13c0: 72 65 67 69 73 74 65 72 65 64 0a 20 20 2a 09 54 registered. *.T
13d0: 63 6c 5f 4f 62 6a 54 79 70 65 27 73 20 61 6e 64 cl_ObjType's and
13e0: 20 74 6f 20 72 65 73 65 74 20 74 68 65 20 74 63 to reset the tc
13f0: 6c 46 72 65 65 4f 62 6a 4c 69 73 74 2e 0a 20 20 lFreeObjList..
1400: 2a 0a 20 20 2a 20 52 65 73 75 6c 74 73 3a 0a 20 *. * Results:.
1410: 20 2a 09 4e 6f 6e 65 2e 0a 20 20 2a 0a 20 20 2a *.None.. *. *
1420: 20 53 69 64 65 20 65 66 66 65 63 74 73 3a 0a 20 Side effects:.
1430: 20 2a 09 4e 6f 6e 65 2e 0a 20 20 2a 0a 20 20 2a *.None.. *. *
1440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1480: 2d 2d 2d 2d 2d 2d 0a 20 20 2a 2f 0a 20 0a 20 76 ------. */. . v
1490: 6f 69 64 0a 20 54 63 6c 46 69 6e 61 6c 69 7a 65 oid. TclFinalize
14a0: 4f 62 6a 65 63 74 73 28 76 6f 69 64 29 0a 20 7b Objects(void). {
14b0: 0a 20 20 20 20 20 54 63 6c 5f 4d 75 74 65 78 4c . Tcl_MutexL
14c0: 6f 63 6b 28 26 74 61 62 6c 65 4d 75 74 65 78 29 ock(&tableMutex)
14d0: 3b 0a 20 20 20 20 20 69 66 20 28 74 79 70 65 54 ;. if (typeT
14e0: 61 62 6c 65 49 6e 69 74 69 61 6c 69 7a 65 64 29 ableInitialized)
14f0: 20 7b 0a 20 09 54 63 6c 5f 44 65 6c 65 74 65 48 {. .Tcl_DeleteH
1500: 61 73 68 54 61 62 6c 65 28 26 74 79 70 65 54 61 ashTable(&typeTa
1510: 62 6c 65 29 3b 0a 20 09 74 79 70 65 54 61 62 6c ble);. .typeTabl
1520: 65 49 6e 69 74 69 61 6c 69 7a 65 64 20 3d 20 30 eInitialized = 0
1530: 3b 0a 20 20 20 20 20 7d 0a 20 20 20 20 20 54 63 ;. }. Tc
1540: 6c 5f 4d 75 74 65 78 55 6e 6c 6f 63 6b 28 26 74 l_MutexUnlock(&t
1550: 61 62 6c 65 4d 75 74 65 78 29 3b 0a 20 0a 20 20 ableMutex);. .
1560: 20 20 20 2f 2a 0a 20 20 20 20 20 20 2a 20 41 6c /*. * Al
1570: 6c 20 77 65 20 64 6f 20 68 65 72 65 20 69 73 20 l we do here is
1580: 72 65 73 65 74 20 74 68 65 20 68 65 61 64 20 70 reset the head p
1590: 6f 69 6e 74 65 72 20 6f 66 20 74 68 65 20 6c 69 ointer of the li
15a0: 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 66 72 65 nked list of fre
15b0: 65 0a 20 20 20 20 20 20 2a 20 54 63 6c 5f 4f 62 e. * Tcl_Ob
15c0: 6a 27 73 20 74 6f 20 4e 55 4c 4c 3b 20 74 68 65 j's to NULL; the
15d0: 20 6d 65 6d 6f 72 79 20 66 69 6e 61 6c 69 7a 61 memory finaliza
15e0: 74 69 6f 6e 20 77 69 6c 6c 20 74 61 6b 65 20 63 tion will take c
15f0: 61 72 65 20 6f 66 20 72 65 6c 65 61 73 69 6e 67 are of releasing
1600: 0a 20 20 20 20 20 20 2a 20 6d 65 6d 6f 72 79 20 . * memory
1610: 66 6f 72 20 75 73 2e 0a 20 20 20 20 20 20 2a 2f for us.. */
1620: 0a 20 20 20 20 20 54 63 6c 5f 4d 75 74 65 78 4c . Tcl_MutexL
1630: 6f 63 6b 28 26 74 63 6c 4f 62 6a 4d 75 74 65 78 ock(&tclObjMutex
1640: 29 3b 0a 20 20 20 20 20 74 63 6c 46 72 65 65 4f );. tclFreeO
1650: 62 6a 4c 69 73 74 20 3d 20 4e 55 4c 4c 3b 0a 20 bjList = NULL;.
1660: 20 20 20 20 54 63 6c 5f 4d 75 74 65 78 55 6e 6c Tcl_MutexUnl
1670: 6f 63 6b 28 26 74 63 6c 4f 62 6a 4d 75 74 65 78 ock(&tclObjMutex
1680: 29 3b 0a 20 7d 0a 20 0c 0a 20 2f 2a 0a 20 20 2a );. }. .. /*. *
1690: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
16a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
16b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
16c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
16d0: 2d 2d 2d 2d 2d 2d 0a 20 20 2a 0a 2b 20 2a 20 42 ------. *.+ * B
16e0: 6f 6f 6b 6b 65 65 70 69 6e 67 20 6f 66 20 6c 69 ookkeeping of li
16f0: 6e 65 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 ne continuation
1700: 28 62 61 63 6b 73 6c 61 73 68 2b 6e 65 77 6c 69 (backslash+newli
1710: 6e 65 29 20 73 65 71 75 65 6e 63 65 73 20 77 69 ne) sequences wi
1720: 74 68 0a 2b 20 2a 20 74 68 65 20 70 75 72 70 6f th.+ * the purpo
1730: 73 65 20 6f 66 20 72 65 70 6f 72 74 69 6e 67 20 se of reporting
1740: 63 6f 72 72 65 63 74 20 6c 69 6e 65 20 6e 75 6d correct line num
1750: 62 65 72 73 20 69 6e 20 74 68 65 20 72 65 73 75 bers in the resu
1760: 6c 74 20 6f 66 0a 2b 20 2a 20 5b 69 6e 66 6f 20 lt of.+ * [info
1770: 66 72 61 6d 65 20 6c 65 76 65 6c 5d 20 69 6e 74 frame level] int
1780: 72 6f 64 75 63 65 73 20 6e 6f 74 69 63 65 61 62 roduces noticeab
1790: 6c 65 20 6f 76 65 72 68 65 61 64 20 69 6e 20 54 le overhead in T
17a0: 63 6c 46 72 65 65 4f 62 6a 28 29 2e 0a 2b 20 2a clFreeObj()..+ *
17b0: 20 54 68 65 72 65 66 6f 72 65 20 74 68 61 74 20 Therefore that
17c0: 66 75 6e 63 74 69 6f 6e 61 6c 69 74 79 20 63 61 functionality ca
17d0: 6e 20 62 65 20 74 75 72 6e 65 64 20 6f 6e 20 6f n be turned on o
17e0: 72 20 6f 66 66 20 76 69 61 20 74 68 65 0a 2b 20 r off via the.+
17f0: 2a 20 65 6e 76 69 72 6f 6e 6d 65 6e 74 20 76 61 * environment va
1800: 72 69 61 62 6c 65 20 54 43 4c 5f 49 4e 46 4f 5f riable TCL_INFO_
1810: 46 52 41 4d 45 5f 45 4e 41 42 4c 45 5f 41 43 43 FRAME_ENABLE_ACC
1820: 55 52 41 54 45 5f 4c 49 4e 45 5f 4e 55 4d 42 45 URATE_LINE_NUMBE
1830: 52 53 0a 2b 20 2a 20 28 73 65 74 74 69 6e 67 20 RS.+ * (setting
1840: 69 74 20 74 6f 20 30 20 72 65 73 75 6c 74 73 20 it to 0 results
1850: 69 6e 20 69 6d 70 72 6f 76 65 64 20 70 65 72 66 in improved perf
1860: 6f 72 6d 61 6e 63 65 20 61 74 20 74 68 65 20 63 ormance at the c
1870: 6f 73 74 20 6f 66 0a 2b 20 2a 20 77 6f 72 73 65 ost of.+ * worse
1880: 20 64 65 62 75 67 67 61 62 69 6c 69 74 79 20 6f debuggability o
1890: 66 20 54 63 6c 20 73 63 72 69 70 74 73 2c 20 77 f Tcl scripts, w
18a0: 68 69 6c 65 20 61 6e 79 20 6f 74 68 65 72 20 76 hile any other v
18b0: 61 6c 75 65 20 68 61 73 20 61 6e 0a 2b 20 2a 20 alue has an.+ *
18c0: 6f 70 70 6f 73 69 74 65 20 65 66 66 65 63 74 29 opposite effect)
18d0: 2e 20 44 75 72 69 6e 67 20 63 6f 6d 70 69 6c 61 . During compila
18e0: 74 69 6f 6e 2c 20 64 65 66 69 6e 69 6e 67 20 61 tion, defining a
18f0: 20 6d 61 63 72 6f 20 77 69 74 68 20 74 68 65 20 macro with the
1900: 73 61 6d 65 0a 2b 20 2a 20 6e 61 6d 65 20 73 65 same.+ * name se
1910: 74 73 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 ts the default v
1920: 61 6c 75 65 20 66 6f 72 20 74 68 61 74 20 73 65 alue for that se
1930: 74 74 69 6e 67 2e 0a 2b 20 2a 0a 2b 20 2a 2d 2d tting..+ *.+ *--
1940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1950: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1960: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1970: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1980: 2d 2d 2d 2d 0a 2b 20 2a 2f 0a 2b 0a 2b 23 69 66 ----.+ */.+.+#if
1990: 6e 64 65 66 20 54 43 4c 5f 49 4e 46 4f 5f 46 52 ndef TCL_INFO_FR
19a0: 41 4d 45 5f 45 4e 41 42 4c 45 5f 41 43 43 55 52 AME_ENABLE_ACCUR
19b0: 41 54 45 5f 4c 49 4e 45 5f 4e 55 4d 42 45 52 53 ATE_LINE_NUMBERS
19c0: 0a 2b 23 64 65 66 69 6e 65 20 54 43 4c 5f 49 4e .+#define TCL_IN
19d0: 46 4f 5f 46 52 41 4d 45 5f 45 4e 41 42 4c 45 5f FO_FRAME_ENABLE_
19e0: 41 43 43 55 52 41 54 45 5f 4c 49 4e 45 5f 4e 55 ACCURATE_LINE_NU
19f0: 4d 42 45 52 53 20 31 0a 2b 23 65 6e 64 69 66 0a MBERS 1.+#endif.
1a00: 2b 0a 2b 73 74 61 74 69 63 20 69 6e 74 20 69 6e +.+static int in
1a10: 66 6f 46 72 61 6d 65 4d 75 73 74 52 65 70 6f 72 foFrameMustRepor
1a20: 74 41 63 63 75 72 61 74 65 4c 69 6e 65 4e 75 6d tAccurateLineNum
1a30: 62 65 72 73 28 76 6f 69 64 29 0a 2b 7b 0a 2b 20 bers(void).+{.+
1a40: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 2a 20 76 const char* v
1a50: 20 3d 20 67 65 74 65 6e 76 28 22 54 43 4c 5f 49 = getenv("TCL_I
1a60: 4e 46 4f 5f 46 52 41 4d 45 5f 45 4e 41 42 4c 45 NFO_FRAME_ENABLE
1a70: 5f 41 43 43 55 52 41 54 45 5f 4c 49 4e 45 5f 4e _ACCURATE_LINE_N
1a80: 55 4d 42 45 52 53 22 29 3b 0a 2b 20 20 20 20 72 UMBERS");.+ r
1a90: 65 74 75 72 6e 20 76 20 3d 3d 20 4e 55 4c 4c 0a eturn v == NULL.
1aa0: 2b 20 20 20 20 20 20 20 20 20 20 20 3f 20 54 43 + ? TC
1ab0: 4c 5f 49 4e 46 4f 5f 46 52 41 4d 45 5f 45 4e 41 L_INFO_FRAME_ENA
1ac0: 42 4c 45 5f 41 43 43 55 52 41 54 45 5f 4c 49 4e BLE_ACCURATE_LIN
1ad0: 45 5f 4e 55 4d 42 45 52 53 0a 2b 20 20 20 20 20 E_NUMBERS.+
1ae0: 20 20 20 20 20 20 3a 20 73 74 72 63 6d 70 28 76 : strcmp(v
1af0: 2c 20 22 30 22 29 20 21 3d 20 30 3b 0a 2b 7d 0a , "0") != 0;.+}.
1b00: 2b 0a 2b 73 74 61 74 69 63 20 69 6e 74 20 6c 69 +.+static int li
1b10: 6e 65 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 73 4d neContinuationsM
1b20: 75 73 74 42 65 54 72 61 63 6b 65 64 28 76 6f 69 ustBeTracked(voi
1b30: 64 29 0a 2b 7b 0a 2b 20 20 20 20 73 74 61 74 69 d).+{.+ stati
1b40: 63 20 69 6e 74 20 78 20 3d 20 2d 31 3b 0a 2b 20 c int x = -1;.+
1b50: 20 20 20 69 66 20 28 20 78 20 3d 3d 20 2d 31 20 if ( x == -1
1b60: 29 0a 2b 20 20 20 20 20 20 20 20 78 20 3d 20 28 ).+ x = (
1b70: 69 6e 66 6f 46 72 61 6d 65 4d 75 73 74 52 65 70 infoFrameMustRep
1b80: 6f 72 74 41 63 63 75 72 61 74 65 4c 69 6e 65 4e ortAccurateLineN
1b90: 75 6d 62 65 72 73 28 29 20 21 3d 20 30 29 3b 0a umbers() != 0);.
1ba0: 2b 20 20 20 20 72 65 74 75 72 6e 20 78 3b 0a 2b + return x;.+
1bb0: 7d 0a 2b 0c 0a 2b 2f 2a 0a 2b 20 2a 2d 2d 2d 2d }.+..+/*.+ *----
1bc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1bd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1be0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1bf0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1c00: 2d 2d 0a 2b 20 2a 0a 20 20 2a 20 54 63 6c 47 65 --.+ *. * TclGe
1c10: 74 43 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 20 2d tContLineTable -
1c20: 2d 0a 20 20 2a 0a 20 20 2a 09 54 68 69 73 20 70 -. *. *.This p
1c30: 72 6f 63 65 64 75 72 65 20 69 73 20 61 20 68 65 rocedure is a he
1c40: 6c 70 65 72 20 77 68 69 63 68 20 72 65 74 75 72 lper which retur
1c50: 6e 73 20 74 68 65 20 74 68 72 65 61 64 2d 73 70 ns the thread-sp
1c60: 65 63 69 66 69 63 0a 20 20 2a 09 68 61 73 68 2d ecific. *.hash-
1c70: 74 61 62 6c 65 20 75 73 65 64 20 74 6f 20 74 72 table used to tr
1c80: 61 63 6b 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e ack continuation
1c90: 20 6c 69 6e 65 20 69 6e 66 6f 72 6d 61 74 69 6f line informatio
1ca0: 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 n associated wit
1cb0: 68 0a 20 20 2a 09 54 63 6c 5f 4f 62 6a 2a 2c 20 h. *.Tcl_Obj*,
1cc0: 61 6e 64 20 74 68 65 20 6f 62 6a 54 68 72 65 61 and the objThrea
1cd0: 64 4d 61 70 2c 20 65 74 63 2e 0a 20 20 2a 0a 20 dMap, etc.. *.
1ce0: 20 2a 20 52 65 73 75 6c 74 73 3a 0a 20 20 2a 09 * Results:. *.
1cf0: 41 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 A reference to t
1d00: 68 65 20 74 68 72 65 61 64 2d 64 61 74 61 2e 0a he thread-data..
1d10: 20 20 2a 0a 20 20 2a 20 53 69 64 65 20 65 66 66 *. * Side eff
1d20: 65 63 74 73 3a 0a 20 20 2a 09 4d 61 79 20 61 6c ects:. *.May al
1d30: 6c 6f 63 61 74 65 20 6d 65 6d 6f 72 79 20 66 6f locate memory fo
1d40: 72 20 74 68 65 20 74 68 72 65 61 64 2d 64 61 74 r the thread-dat
1d50: 61 2e 0a 20 20 2a 0a 20 20 2a 20 54 49 50 20 23 a.. *. * TIP #
1d60: 32 38 30 0a 20 20 2a 2d 2d 2d 2d 2d 2d 2d 2d 2d 280. *---------
1d70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1d80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1d90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
1da0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 -------------.
1db0: 2a 2f 0a 20 0a 2d 73 74 61 74 69 63 20 54 68 72 */. .-static Thr
1dc0: 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 20 eadSpecificData
1dd0: 2a 0a 2b 73 74 61 74 69 63 20 54 63 6c 5f 48 61 *.+static Tcl_Ha
1de0: 73 68 54 61 62 6c 65 20 2a 0a 20 54 63 6c 47 65 shTable *. TclGe
1df0: 74 43 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 28 76 tContLineTable(v
1e00: 6f 69 64 29 0a 20 7b 0a 2b 20 20 20 20 54 68 72 oid). {.+ Thr
1e10: 65 61 64 53 70 65 63 69 66 69 63 44 61 74 61 20 eadSpecificData
1e20: 2a 74 73 64 50 74 72 3b 0a 2b 0a 2b 20 20 20 20 *tsdPtr;.+.+
1e30: 69 66 20 28 20 21 20 6c 69 6e 65 43 6f 6e 74 69 if ( ! lineConti
1e40: 6e 75 61 74 69 6f 6e 73 4d 75 73 74 42 65 54 72 nuationsMustBeTr
1e50: 61 63 6b 65 64 28 29 20 29 0a 2b 20 20 20 20 20 acked() ).+
1e60: 20 20 20 72 65 74 75 72 6e 20 4e 55 4c 4c 3b 0a return NULL;.
1e70: 2b 0a 20 20 20 20 20 2f 2a 0a 20 20 20 20 20 20 +. /*.
1e80: 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 * Initialize the
1e90: 20 68 61 73 68 74 61 62 6c 65 20 74 72 61 63 6b hashtable track
1ea0: 69 6e 67 20 69 6e 76 69 73 69 62 6c 65 20 63 6f ing invisible co
1eb0: 6e 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 73 ntinuation lines
1ec0: 2e 20 20 46 6f 72 0a 20 20 20 20 20 20 2a 20 74 . For. * t
1ed0: 68 65 20 72 65 6c 65 61 73 65 20 77 65 20 75 73 he release we us
1ee0: 65 20 61 20 74 68 72 65 61 64 20 65 78 69 74 20 e a thread exit
1ef0: 68 61 6e 64 6c 65 72 20 74 6f 20 65 6e 73 75 72 handler to ensur
1f00: 65 20 74 68 61 74 20 74 68 69 73 20 69 73 20 64 e that this is d
1f10: 6f 6e 65 0a 20 20 20 20 20 20 2a 20 62 65 66 6f one. * befo
1f20: 72 65 20 54 53 44 20 62 6c 6f 63 6b 73 20 61 72 re TSD blocks ar
1f30: 65 20 6d 61 64 65 20 69 6e 76 61 6c 69 64 2e 20 e made invalid.
1f40: 54 68 65 20 54 63 6c 46 69 6e 61 6c 69 7a 65 4f The TclFinalizeO
1f50: 62 6a 65 63 74 73 28 29 20 77 68 69 63 68 0a 20 bjects() which.
1f60: 20 20 20 20 20 2a 20 77 6f 75 6c 64 20 62 65 20 * would be
1f70: 74 68 65 20 6e 61 74 75 72 61 6c 20 70 6c 61 63 the natural plac
1f80: 65 20 66 6f 72 20 74 68 69 73 20 69 73 20 69 6e e for this is in
1f90: 76 6f 6b 65 64 20 61 66 74 65 72 77 61 72 64 73 voked afterwards
1fa0: 2c 20 6d 65 61 6e 69 6e 67 20 74 68 61 74 0a 20 , meaning that.
1fb0: 20 20 20 20 20 2a 20 77 65 20 74 72 79 20 74 6f * we try to
1fc0: 20 6f 70 65 72 61 74 65 20 6f 6e 20 61 20 64 61 operate on a da
1fd0: 74 61 20 73 74 72 75 63 74 75 72 65 20 61 6c 72 ta structure alr
1fe0: 65 61 64 79 20 67 6f 6e 65 2e 0a 20 20 20 20 20 eady gone..
1ff0: 20 2a 2f 0a 20 0a 2d 20 20 20 20 54 68 72 65 61 */. .- Threa
2000: 64 53 70 65 63 69 66 69 63 44 61 74 61 20 2a 74 dSpecificData *t
2010: 73 64 50 74 72 20 3d 20 54 43 4c 5f 54 53 44 5f sdPtr = TCL_TSD_
2020: 49 4e 49 54 28 26 64 61 74 61 4b 65 79 29 3b 0a INIT(&dataKey);.
2030: 2b 20 20 20 20 74 73 64 50 74 72 20 3d 20 54 43 + tsdPtr = TC
2040: 4c 5f 54 53 44 5f 49 4e 49 54 28 26 64 61 74 61 L_TSD_INIT(&data
2050: 4b 65 79 29 3b 0a 20 0a 20 20 20 20 20 69 66 20 Key);. . if
2060: 28 21 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 4c (!tsdPtr->lineCL
2070: 50 74 72 29 20 7b 0a 20 09 74 73 64 50 74 72 2d Ptr) {. .tsdPtr-
2080: 3e 6c 69 6e 65 43 4c 50 74 72 20 3d 20 54 63 6c >lineCLPtr = Tcl
2090: 5f 41 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 54 63 _Alloc(sizeof(Tc
20a0: 6c 5f 48 61 73 68 54 61 62 6c 65 29 29 3b 0a 20 l_HashTable));.
20b0: 09 54 63 6c 5f 49 6e 69 74 48 61 73 68 54 61 62 .Tcl_InitHashTab
20c0: 6c 65 28 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 le(tsdPtr->lineC
20d0: 4c 50 74 72 2c 20 54 43 4c 5f 4f 4e 45 5f 57 4f LPtr, TCL_ONE_WO
20e0: 52 44 5f 4b 45 59 53 29 3b 0a 20 09 54 63 6c 5f RD_KEYS);. .Tcl_
20f0: 43 72 65 61 74 65 54 68 72 65 61 64 45 78 69 74 CreateThreadExit
2100: 48 61 6e 64 6c 65 72 28 54 63 6c 54 68 72 65 61 Handler(TclThrea
2110: 64 46 69 6e 61 6c 69 7a 65 43 6f 6e 74 4c 69 6e dFinalizeContLin
2120: 65 73 2c 4e 55 4c 4c 29 3b 0a 20 20 20 20 20 7d es,NULL);. }
2130: 0a 2d 20 20 20 20 72 65 74 75 72 6e 20 74 73 64 .- return tsd
2140: 50 74 72 3b 0a 2b 20 20 20 20 72 65 74 75 72 6e Ptr;.+ return
2150: 20 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 4c 50 tsdPtr->lineCLP
2160: 74 72 3b 0a 20 7d 0a 20 0c 0a 20 2f 2a 0a 20 20 tr;. }. .. /*.
2170: 2a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d *---------------
2180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
21a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
21b0: 2d 2d 2d 2d 2d 2d 2d 0a 20 20 2a 0a 20 20 2a 20 -------. *. *
21c0: 54 63 6c 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 73 TclContinuations
21d0: 45 6e 74 65 72 20 2d 2d 0a 20 20 2a 0a 20 20 2a Enter --. *. *
21e0: 09 54 68 69 73 20 70 72 6f 63 65 64 75 72 65 20 .This procedure
21f0: 69 73 20 61 20 68 65 6c 70 65 72 20 77 68 69 63 is a helper whic
2200: 68 20 73 61 76 65 73 20 74 68 65 20 63 6f 6e 74 h saves the cont
2210: 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 0a 20 20 inuation line.
2220: 2a 09 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 73 *.information as
2230: 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 61 20 sociated with a
2240: 54 63 6c 5f 4f 62 6a 2a 2e 0a 20 20 2a 0a 20 20 Tcl_Obj*.. *.
2250: 2a 20 52 65 73 75 6c 74 73 3a 0a 20 20 2a 09 41 * Results:. *.A
2260: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 74 68 reference to th
2270: 65 20 6e 65 77 6c 79 20 63 72 65 61 74 65 64 20 e newly created
2280: 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e continuation lin
2290: 65 20 6c 6f 63 61 74 69 6f 6e 20 74 61 62 6c 65 e location table
22a0: 2e 0a 20 20 2a 0a 20 20 2a 20 53 69 64 65 20 65 .. *. * Side e
22b0: 66 66 65 63 74 73 3a 0a 20 20 2a 09 41 6c 6c 6f ffects:. *.Allo
22c0: 63 61 74 65 73 20 6d 65 6d 6f 72 79 20 66 6f 72 cates memory for
22d0: 20 74 68 65 20 74 61 62 6c 65 20 6f 66 20 63 6f the table of co
22e0: 6e 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 20 ntinuation line
22f0: 6c 6f 63 61 74 69 6f 6e 73 2e 0a 20 20 2a 0a 20 locations.. *.
2300: 20 2a 20 54 49 50 20 23 32 38 30 0a 20 20 2a 2d * TIP #280. *-
2310: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2320: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2330: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2340: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2350: 2d 2d 2d 2d 2d 0a 20 20 2a 2f 0a 20 0a 20 43 6f -----. */. . Co
2360: 6e 74 4c 69 6e 65 4c 6f 63 20 2a 0a 20 54 63 6c ntLineLoc *. Tcl
2370: 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 73 45 6e 74 ContinuationsEnt
2380: 65 72 28 0a 20 20 20 20 20 54 63 6c 5f 4f 62 6a er(. Tcl_Obj
2390: 20 2a 6f 62 6a 50 74 72 2c 0a 20 20 20 20 20 69 *objPtr,. i
23a0: 6e 74 20 6e 75 6d 2c 0a 20 20 20 20 20 69 6e 74 nt num,. int
23b0: 20 2a 6c 6f 63 29 0a 20 7b 0a 20 20 20 20 20 69 *loc). {. i
23c0: 6e 74 20 6e 65 77 45 6e 74 72 79 3b 0a 2d 20 20 nt newEntry;.-
23d0: 20 20 54 68 72 65 61 64 53 70 65 63 69 66 69 63 ThreadSpecific
23e0: 44 61 74 61 20 2a 74 73 64 50 74 72 20 3d 20 54 Data *tsdPtr = T
23f0: 63 6c 47 65 74 43 6f 6e 74 4c 69 6e 65 54 61 62 clGetContLineTab
2400: 6c 65 28 29 3b 0a 2d 20 20 20 20 54 63 6c 5f 48 le();.- Tcl_H
2410: 61 73 68 45 6e 74 72 79 20 2a 68 50 74 72 20 3d ashEntry *hPtr =
2420: 0a 2d 09 20 20 20 20 54 63 6c 5f 43 72 65 61 74 .-. Tcl_Creat
2430: 65 48 61 73 68 45 6e 74 72 79 28 74 73 64 50 74 eHashEntry(tsdPt
2440: 72 2d 3e 6c 69 6e 65 43 4c 50 74 72 2c 20 6f 62 r->lineCLPtr, ob
2450: 6a 50 74 72 2c 20 26 6e 65 77 45 6e 74 72 79 29 jPtr, &newEntry)
2460: 3b 0a 2d 20 20 20 20 43 6f 6e 74 4c 69 6e 65 4c ;.- ContLineL
2470: 6f 63 20 2a 63 6c 4c 6f 63 50 74 72 20 3d 20 54 oc *clLocPtr = T
2480: 63 6c 5f 41 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 cl_Alloc(sizeof(
2490: 43 6f 6e 74 4c 69 6e 65 4c 6f 63 29 20 2b 20 6e ContLineLoc) + n
24a0: 75 6d 2a 73 69 7a 65 6f 66 28 69 6e 74 29 29 3b um*sizeof(int));
24b0: 0a 2b 20 20 20 20 54 63 6c 5f 48 61 73 68 45 6e .+ Tcl_HashEn
24c0: 74 72 79 20 2a 68 50 74 72 3b 0a 2b 20 20 20 20 try *hPtr;.+
24d0: 43 6f 6e 74 4c 69 6e 65 4c 6f 63 20 2a 63 6c 4c ContLineLoc *clL
24e0: 6f 63 50 74 72 3b 0a 2b 0a 2b 20 20 20 20 54 63 ocPtr;.+.+ Tc
24f0: 6c 5f 48 61 73 68 54 61 62 6c 65 20 2a 63 6f 6e l_HashTable *con
2500: 74 4c 69 6e 65 54 61 62 6c 65 20 3d 20 54 63 6c tLineTable = Tcl
2510: 47 65 74 43 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 GetContLineTable
2520: 28 29 3b 0a 2b 20 20 20 20 69 66 20 28 20 21 20 ();.+ if ( !
2530: 63 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 20 29 0a contLineTable ).
2540: 2b 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 + return
2550: 4e 55 4c 4c 3b 0a 2b 0a 2b 20 20 20 20 68 50 74 NULL;.+.+ hPt
2560: 72 20 3d 20 54 63 6c 5f 43 72 65 61 74 65 48 61 r = Tcl_CreateHa
2570: 73 68 45 6e 74 72 79 28 63 6f 6e 74 4c 69 6e 65 shEntry(contLine
2580: 54 61 62 6c 65 2c 20 6f 62 6a 50 74 72 2c 20 26 Table, objPtr, &
2590: 6e 65 77 45 6e 74 72 79 29 3b 0a 2b 20 20 20 20 newEntry);.+
25a0: 63 6c 4c 6f 63 50 74 72 20 3d 20 54 63 6c 5f 41 clLocPtr = Tcl_A
25b0: 6c 6c 6f 63 28 73 69 7a 65 6f 66 28 43 6f 6e 74 lloc(sizeof(Cont
25c0: 4c 69 6e 65 4c 6f 63 29 20 2b 20 6e 75 6d 2a 73 LineLoc) + num*s
25d0: 69 7a 65 6f 66 28 69 6e 74 29 29 3b 0a 20 0a 20 izeof(int));. .
25e0: 20 20 20 20 69 66 20 28 21 6e 65 77 45 6e 74 72 if (!newEntr
25f0: 79 29 20 7b 0a 20 09 2f 2a 0a 20 09 20 2a 20 57 y) {. ./*. . * W
2600: 65 27 72 65 20 65 6e 74 65 72 69 6e 67 20 43 6f e're entering Co
2610: 6e 74 4c 69 6e 65 4c 6f 63 20 64 61 74 61 20 66 ntLineLoc data f
2620: 6f 72 20 74 68 65 20 73 61 6d 65 20 76 61 6c 75 or the same valu
2630: 65 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 0a e more than one.
2640: 20 09 20 2a 20 74 69 6d 65 2e 20 54 61 6b 69 6e . * time. Takin
2650: 67 20 63 61 72 65 20 6e 6f 74 20 74 6f 20 6c 65 g care not to le
2660: 61 6b 20 74 68 65 20 6f 6c 64 20 65 6e 74 72 79 ak the old entry
2670: 2e 0a 20 09 20 2a 0a 20 09 20 2a 20 54 68 69 73 .. . *. . * This
2680: 20 63 61 6e 20 68 61 70 70 65 6e 20 77 68 65 6e can happen when
2690: 20 6c 69 74 65 72 61 6c 73 20 69 6e 20 61 20 70 literals in a p
26a0: 72 6f 63 20 62 6f 64 79 20 61 72 65 20 73 68 61 roc body are sha
26b0: 72 65 64 2e 20 53 65 65 20 66 6f 72 0a 20 09 20 red. See for. .
26c0: 2a 20 65 78 61 6d 70 6c 65 20 74 65 73 74 20 69 * example test i
26d0: 6e 66 6f 2d 33 30 2e 31 39 20 77 68 65 72 65 20 nfo-30.19 where
26e0: 74 68 65 20 61 63 74 69 6f 6e 20 28 63 6f 64 65 the action (code
26f0: 29 20 66 6f 72 20 61 6c 6c 20 62 72 61 6e 63 68 ) for all branch
2700: 65 73 20 6f 66 0a 20 09 20 2a 20 74 68 65 20 73 es of. . * the s
2710: 77 69 74 63 68 20 63 6f 6d 6d 61 6e 64 20 69 73 witch command is
2720: 20 69 64 65 6e 74 69 63 61 6c 2c 20 6d 61 70 70 identical, mapp
2730: 69 6e 67 20 74 68 65 6d 20 61 6c 6c 20 74 6f 20 ing them all to
2740: 74 68 65 20 73 61 6d 65 0a 20 09 20 2a 20 6c 69 the same. . * li
2750: 74 65 72 61 6c 2e 20 41 6e 20 69 6e 74 65 72 65 teral. An intere
2760: 73 74 69 6e 67 20 72 65 73 75 6c 74 20 6f 66 20 sting result of
2770: 74 68 69 73 20 69 73 20 74 68 61 74 20 74 68 65 this is that the
2780: 20 6e 75 6d 62 65 72 20 61 6e 64 0a 20 09 20 2a number and. . *
2790: 20 6c 6f 63 61 74 69 6f 6e 73 20 28 6f 66 66 73 locations (offs
27a0: 65 74 29 20 6f 66 20 69 6e 76 69 73 69 62 6c 65 et) of invisible
27b0: 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 6c 69 continuation li
27c0: 6e 65 73 20 69 6e 20 74 68 65 20 6c 69 74 65 72 nes in the liter
27d0: 61 6c 0a 20 09 20 2a 20 61 72 65 20 74 68 65 20 al. . * are the
27e0: 73 61 6d 65 20 66 6f 72 20 61 6c 6c 20 6f 63 63 same for all occ
27f0: 75 72 65 6e 63 65 73 2e 0a 20 09 20 2a 0a 20 09 urences.. . *. .
2800: 20 2a 20 4e 6f 74 65 20 74 68 61 74 20 77 68 69 * Note that whi
2810: 6c 65 20 72 65 75 73 69 6e 67 20 74 68 65 20 65 le reusing the e
2820: 78 69 73 74 69 6e 67 20 65 6e 74 72 79 20 69 73 xisting entry is
2830: 20 70 6f 73 73 69 62 6c 65 20 69 74 20 72 65 71 possible it req
2840: 75 69 72 65 73 0a 20 09 20 2a 20 74 68 65 20 73 uires. . * the s
2850: 61 6d 65 20 61 63 74 69 6f 6e 73 20 61 73 20 66 ame actions as f
2860: 6f 72 20 61 20 6e 65 77 20 65 6e 74 72 79 20 62 or a new entry b
2870: 65 63 61 75 73 65 20 77 65 20 68 61 76 65 20 74 ecause we have t
2880: 6f 20 63 6f 70 79 20 74 68 65 0a 20 09 20 2a 20 o copy the. . *
2890: 69 6e 63 6f 6d 69 6e 67 20 6e 75 6d 2f 6c 6f 63 incoming num/loc
28a0: 20 64 61 74 61 20 65 76 65 6e 20 73 6f 2e 20 42 data even so. B
28b0: 65 63 61 75 73 65 20 77 65 20 61 72 65 20 63 61 ecause we are ca
28c0: 6c 6c 65 64 20 66 72 6f 6d 0a 20 09 20 2a 20 54 lled from. . * T
28d0: 63 6c 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 73 45 clContinuationsE
28e0: 6e 74 65 72 44 65 72 69 76 65 64 20 66 6f 72 20 nterDerived for
28f0: 74 68 69 73 20 63 61 73 65 2c 20 77 68 69 63 68 this case, which
2900: 20 6d 6f 64 69 66 69 65 64 20 74 68 65 0a 20 09 modified the. .
2910: 20 2a 20 73 74 6f 72 65 64 20 6c 6f 63 61 74 69 * stored locati
2920: 6f 6e 73 20 28 52 65 62 61 73 65 64 20 74 6f 20 ons (Rebased to
2930: 74 68 65 20 70 72 6f 70 65 72 20 72 65 6c 61 74 the proper relat
2940: 69 76 65 20 6f 66 66 73 65 74 29 2e 20 4a 75 73 ive offset). Jus
2950: 74 0a 20 09 20 2a 20 72 65 74 75 72 6e 69 6e 67 t. . * returning
2960: 20 74 68 65 20 73 74 6f 72 65 64 20 65 6e 74 72 the stored entr
2970: 79 20 77 6f 75 6c 64 20 72 65 62 61 73 65 20 74 y would rebase t
2980: 68 65 6d 20 61 20 73 65 63 6f 6e 64 20 74 69 6d hem a second tim
2990: 65 2c 20 6f 72 0a 20 09 20 2a 20 6d 6f 72 65 2c e, or. . * more,
29a0: 20 68 6f 73 69 6e 67 20 74 68 65 20 64 61 74 61 hosing the data
29b0: 2e 20 49 74 20 69 73 20 65 61 73 69 65 72 20 74 . It is easier t
29c0: 6f 20 73 69 6d 70 6c 79 20 72 65 70 6c 61 63 65 o simply replace
29d0: 2c 20 61 73 20 77 65 20 61 72 65 0a 20 09 20 2a , as we are. . *
29e0: 20 64 6f 69 6e 67 2e 0a 20 09 20 2a 2f 0a 20 0a doing.. . */. .
29f0: 20 09 54 63 6c 5f 46 72 65 65 28 54 63 6c 5f 47 .Tcl_Free(Tcl_G
2a00: 65 74 48 61 73 68 56 61 6c 75 65 28 68 50 74 72 etHashValue(hPtr
2a10: 29 29 3b 0a 20 20 20 20 20 7d 0a 20 0a 20 20 20 ));. }. .
2a20: 20 20 63 6c 4c 6f 63 50 74 72 2d 3e 6e 75 6d 20 clLocPtr->num
2a30: 3d 20 6e 75 6d 3b 0a 20 20 20 20 20 6d 65 6d 63 = num;. memc
2a40: 70 79 28 26 63 6c 4c 6f 63 50 74 72 2d 3e 6c 6f py(&clLocPtr->lo
2a50: 63 2c 20 6c 6f 63 2c 20 6e 75 6d 2a 73 69 7a 65 c, loc, num*size
2a60: 6f 66 28 69 6e 74 29 29 3b 0a 20 20 20 20 20 63 of(int));. c
2a70: 6c 4c 6f 63 50 74 72 2d 3e 6c 6f 63 5b 6e 75 6d lLocPtr->loc[num
2a80: 5d 20 3d 20 43 4c 4c 5f 45 4e 44 3b 20 20 20 20 ] = CLL_END;
2a90: 20 20 20 2f 2a 20 53 65 6e 74 69 6e 65 6c 20 2a /* Sentinel *
2aa0: 2f 0a 20 20 20 20 20 54 63 6c 5f 53 65 74 48 61 /. Tcl_SetHa
2ab0: 73 68 56 61 6c 75 65 28 68 50 74 72 2c 20 63 6c shValue(hPtr, cl
2ac0: 4c 6f 63 50 74 72 29 3b 0a 20 0a 20 20 20 20 20 LocPtr);. .
2ad0: 72 65 74 75 72 6e 20 63 6c 4c 6f 63 50 74 72 3b return clLocPtr;
2ae0: 0a 20 7d 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d . }. .. /*. *--
2af0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2b00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2b10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2b20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2b30: 2d 2d 2d 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c ----. *. * Tcl
2b40: 43 6f 6e 74 69 6e 75 61 74 69 6f 6e 73 45 6e 74 ContinuationsEnt
2b50: 65 72 44 65 72 69 76 65 64 20 2d 2d 0a 20 20 2a erDerived --. *
2b60: 0a 20 20 2a 09 54 68 69 73 20 70 72 6f 63 65 64 . *.This proced
2b70: 75 72 65 20 69 73 20 61 20 68 65 6c 70 65 72 20 ure is a helper
2b80: 77 68 69 63 68 20 63 6f 6d 70 75 74 65 73 20 74 which computes t
2b90: 68 65 20 63 6f 6e 74 69 6e 75 61 74 69 6f 6e 20 he continuation
2ba0: 6c 69 6e 65 0a 20 20 2a 09 69 6e 66 6f 72 6d 61 line. *.informa
2bb0: 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 tion associated
2bc0: 77 69 74 68 20 61 20 54 63 6c 5f 4f 62 6a 2a 20 with a Tcl_Obj*
2bd0: 63 75 74 20 66 72 6f 6d 20 74 68 65 20 6d 69 64 cut from the mid
2be0: 64 6c 65 20 6f 66 20 61 0a 20 20 2a 09 73 63 72 dle of a. *.scr
2bf0: 69 70 74 2e 0a 20 20 2a 0a 20 20 2a 20 52 65 73 ipt.. *. * Res
2c00: 75 6c 74 73 3a 0a 20 20 2a 09 4e 6f 6e 65 2e 0a ults:. *.None..
2c10: 20 20 2a 0a 20 20 2a 20 53 69 64 65 20 65 66 66 *. * Side eff
2c20: 65 63 74 73 3a 0a 20 20 2a 09 41 6c 6c 6f 63 61 ects:. *.Alloca
2c30: 74 65 73 20 6d 65 6d 6f 72 79 20 66 6f 72 20 74 tes memory for t
2c40: 68 65 20 74 61 62 6c 65 20 6f 66 20 63 6f 6e 74 he table of cont
2c50: 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 20 6c 6f inuation line lo
2c60: 63 61 74 69 6f 6e 73 2e 0a 20 20 2a 0a 20 20 2a cations.. *. *
2c70: 20 54 49 50 20 23 32 38 30 0a 40 40 20 2d 36 35 TIP #280.@@ -65
2c80: 33 2c 31 38 33 20 2b 36 39 39 2c 31 39 35 20 40 3,183 +699,195 @
2c90: 40 0a 20 20 20 20 20 6e 75 6d 20 3d 20 77 6f 72 @. num = wor
2ca0: 64 43 4c 4c 61 73 74 20 2d 20 63 6c 4e 65 78 74 dCLLast - clNext
2cb0: 3b 0a 20 20 20 20 20 69 66 20 28 6e 75 6d 29 20 ;. if (num)
2cc0: 7b 0a 20 09 69 6e 74 20 69 3b 0a 20 09 43 6f 6e {. .int i;. .Con
2cd0: 74 4c 69 6e 65 4c 6f 63 20 2a 63 6c 4c 6f 63 50 tLineLoc *clLocP
2ce0: 74 72 20 3d 20 54 63 6c 43 6f 6e 74 69 6e 75 61 tr = TclContinua
2cf0: 74 69 6f 6e 73 45 6e 74 65 72 28 6f 62 6a 50 74 tionsEnter(objPt
2d00: 72 2c 20 6e 75 6d 2c 20 63 6c 4e 65 78 74 29 3b r, num, clNext);
2d10: 0a 20 0a 20 09 2f 2a 0a 20 09 20 2a 20 52 65 2d . . ./*. . * Re-
2d20: 62 61 73 65 20 74 68 65 20 6c 6f 63 61 74 69 6f base the locatio
2d30: 6e 73 2e 0a 20 09 20 2a 2f 0a 20 0a 20 09 66 6f ns.. . */. . .fo
2d40: 72 20 28 69 3d 30 20 3b 20 69 3c 6e 75 6d 20 3b r (i=0 ; i<num ;
2d50: 20 69 2b 2b 29 20 7b 0a 20 09 20 20 20 20 63 6c i++) {. . cl
2d60: 4c 6f 63 50 74 72 2d 3e 6c 6f 63 5b 69 5d 20 2d LocPtr->loc[i] -
2d70: 3d 20 73 74 61 72 74 3b 0a 20 0a 20 09 20 20 20 = start;. . .
2d80: 20 2f 2a 0a 20 09 20 20 20 20 20 2a 20 43 6f 6e /*. . * Con
2d90: 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 73 20 tinuation lines
2da0: 63 6f 6d 69 6e 67 20 62 65 66 6f 72 65 20 74 68 coming before th
2db0: 65 20 73 74 72 69 6e 67 20 61 6e 64 20 61 66 66 e string and aff
2dc0: 65 63 74 69 6e 67 20 75 73 0a 20 09 20 20 20 20 ecting us. .
2dd0: 20 2a 20 73 68 6f 75 6c 64 20 6e 6f 74 20 68 61 * should not ha
2de0: 70 70 65 6e 2c 20 64 75 65 20 74 6f 20 74 68 65 ppen, due to the
2df0: 20 70 72 6f 70 65 72 20 6d 61 69 6e 74 65 6e 61 proper maintena
2e00: 6e 63 65 20 6f 66 20 63 6c 4e 65 78 74 0a 20 09 nce of clNext. .
2e10: 20 20 20 20 20 2a 20 64 75 72 69 6e 67 20 63 6f * during co
2e20: 6d 70 69 6c 61 74 69 6f 6e 2e 0a 20 09 20 20 20 mpilation.. .
2e30: 20 20 2a 2f 0a 20 0a 20 09 20 20 20 20 69 66 20 */. . . if
2e40: 28 63 6c 4c 6f 63 50 74 72 2d 3e 6c 6f 63 5b 69 (clLocPtr->loc[i
2e50: 5d 20 3c 20 30 29 20 7b 0a 20 09 09 54 63 6c 5f ] < 0) {. ..Tcl_
2e60: 50 61 6e 69 63 28 22 44 65 72 69 76 65 64 20 49 Panic("Derived I
2e70: 43 4c 20 64 61 74 61 20 66 6f 72 20 6f 62 6a 65 CL data for obje
2e80: 63 74 20 75 73 69 6e 67 20 6f 66 66 73 65 74 73 ct using offsets
2e90: 20 66 72 6f 6d 20 62 65 66 6f 72 65 20 74 68 65 from before the
2ea0: 20 73 63 72 69 70 74 22 29 3b 0a 20 09 20 20 20 script");. .
2eb0: 20 7d 0a 20 09 7d 0a 20 20 20 20 20 7d 0a 20 7d }. .}. }. }
2ec0: 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d 2d 2d 2d . .. /*. *-----
2ed0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2ee0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2ef0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2f00: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
2f10: 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c 43 6f 6e -. *. * TclCon
2f20: 74 69 6e 75 61 74 69 6f 6e 73 43 6f 70 79 20 2d tinuationsCopy -
2f30: 2d 0a 20 20 2a 0a 20 20 2a 09 54 68 69 73 20 70 -. *. *.This p
2f40: 72 6f 63 65 64 75 72 65 20 69 73 20 61 20 68 65 rocedure is a he
2f50: 6c 70 65 72 20 77 68 69 63 68 20 63 6f 70 69 65 lper which copie
2f60: 73 20 74 68 65 20 63 6f 6e 74 69 6e 75 61 74 69 s the continuati
2f70: 6f 6e 20 6c 69 6e 65 0a 20 20 2a 09 69 6e 66 6f on line. *.info
2f80: 72 6d 61 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 rmation associat
2f90: 65 64 20 77 69 74 68 20 61 20 54 63 6c 5f 4f 62 ed with a Tcl_Ob
2fa0: 6a 2a 20 74 6f 20 61 6e 6f 74 68 65 72 20 54 63 j* to another Tc
2fb0: 6c 5f 4f 62 6a 2a 2e 20 49 74 20 69 73 0a 20 20 l_Obj*. It is.
2fc0: 2a 09 61 73 73 75 6d 65 64 20 74 68 61 74 20 62 *.assumed that b
2fd0: 6f 74 68 20 63 6f 6e 74 61 69 6e 20 74 68 65 20 oth contain the
2fe0: 73 61 6d 65 20 73 74 72 69 6e 67 2f 73 63 72 69 same string/scri
2ff0: 70 74 2e 20 55 73 65 20 74 68 69 73 20 77 68 65 pt. Use this whe
3000: 6e 20 61 0a 20 20 2a 09 73 63 72 69 70 74 20 69 n a. *.script i
3010: 73 20 64 75 70 6c 69 63 61 74 65 64 20 62 65 63 s duplicated bec
3020: 61 75 73 65 20 69 74 20 77 61 73 20 73 68 61 72 ause it was shar
3030: 65 64 2e 0a 20 20 2a 0a 20 20 2a 20 52 65 73 75 ed.. *. * Resu
3040: 6c 74 73 3a 0a 20 20 2a 09 4e 6f 6e 65 2e 0a 20 lts:. *.None..
3050: 20 2a 0a 20 20 2a 20 53 69 64 65 20 65 66 66 65 *. * Side effe
3060: 63 74 73 3a 0a 20 20 2a 09 41 6c 6c 6f 63 61 74 cts:. *.Allocat
3070: 65 73 20 6d 65 6d 6f 72 79 20 66 6f 72 20 74 68 es memory for th
3080: 65 20 74 61 62 6c 65 20 6f 66 20 63 6f 6e 74 69 e table of conti
3090: 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 20 6c 6f 63 nuation line loc
30a0: 61 74 69 6f 6e 73 2e 0a 20 20 2a 0a 20 20 2a 20 ations.. *. *
30b0: 54 49 50 20 23 32 38 30 0a 20 20 2a 2d 2d 2d 2d TIP #280. *----
30c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
30d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
30e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
30f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3100: 2d 2d 0a 20 20 2a 2f 0a 20 0a 20 76 6f 69 64 0a --. */. . void.
3110: 20 54 63 6c 43 6f 6e 74 69 6e 75 61 74 69 6f 6e TclContinuation
3120: 73 43 6f 70 79 28 0a 20 20 20 20 20 54 63 6c 5f sCopy(. Tcl_
3130: 4f 62 6a 20 2a 6f 62 6a 50 74 72 2c 0a 20 20 20 Obj *objPtr,.
3140: 20 20 54 63 6c 5f 4f 62 6a 20 2a 6f 72 69 67 69 Tcl_Obj *origi
3150: 6e 4f 62 6a 50 74 72 29 0a 20 7b 0a 2d 20 20 20 nObjPtr). {.-
3160: 20 54 68 72 65 61 64 53 70 65 63 69 66 69 63 44 ThreadSpecificD
3170: 61 74 61 20 2a 74 73 64 50 74 72 20 3d 20 54 63 ata *tsdPtr = Tc
3180: 6c 47 65 74 43 6f 6e 74 4c 69 6e 65 54 61 62 6c lGetContLineTabl
3190: 65 28 29 3b 0a 2d 20 20 20 20 54 63 6c 5f 48 61 e();.- Tcl_Ha
31a0: 73 68 45 6e 74 72 79 20 2a 68 50 74 72 20 3d 0a shEntry *hPtr =.
31b0: 2d 20 20 20 20 20 20 20 20 20 20 20 20 54 63 6c - Tcl
31c0: 5f 46 69 6e 64 48 61 73 68 45 6e 74 72 79 28 74 _FindHashEntry(t
31d0: 73 64 50 74 72 2d 3e 6c 69 6e 65 43 4c 50 74 72 sdPtr->lineCLPtr
31e0: 2c 20 6f 72 69 67 69 6e 4f 62 6a 50 74 72 29 3b , originObjPtr);
31f0: 0a 2b 20 20 20 20 54 63 6c 5f 48 61 73 68 45 6e .+ Tcl_HashEn
3200: 74 72 79 20 2a 68 50 74 72 3b 0a 2b 20 20 20 20 try *hPtr;.+
3210: 54 63 6c 5f 48 61 73 68 54 61 62 6c 65 20 2a 63 Tcl_HashTable *c
3220: 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 20 3d 20 54 ontLineTable = T
3230: 63 6c 47 65 74 43 6f 6e 74 4c 69 6e 65 54 61 62 clGetContLineTab
3240: 6c 65 28 29 3b 0a 2b 20 20 20 20 69 66 20 28 20 le();.+ if (
3250: 21 20 63 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 20 ! contLineTable
3260: 29 0a 2b 20 20 20 20 20 20 20 20 72 65 74 75 72 ).+ retur
3270: 6e 3b 0a 2b 0a 2b 20 20 20 20 68 50 74 72 20 3d n;.+.+ hPtr =
3280: 20 54 63 6c 5f 46 69 6e 64 48 61 73 68 45 6e 74 Tcl_FindHashEnt
3290: 72 79 28 63 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 ry(contLineTable
32a0: 2c 20 6f 72 69 67 69 6e 4f 62 6a 50 74 72 29 3b , originObjPtr);
32b0: 0a 20 0a 20 20 20 20 20 69 66 20 28 68 50 74 72 . . if (hPtr
32c0: 29 20 7b 0a 20 09 43 6f 6e 74 4c 69 6e 65 4c 6f ) {. .ContLineLo
32d0: 63 20 2a 63 6c 4c 6f 63 50 74 72 20 3d 20 54 63 c *clLocPtr = Tc
32e0: 6c 5f 47 65 74 48 61 73 68 56 61 6c 75 65 28 68 l_GetHashValue(h
32f0: 50 74 72 29 3b 0a 20 0a 20 09 54 63 6c 43 6f 6e Ptr);. . .TclCon
3300: 74 69 6e 75 61 74 69 6f 6e 73 45 6e 74 65 72 28 tinuationsEnter(
3310: 6f 62 6a 50 74 72 2c 20 63 6c 4c 6f 63 50 74 72 objPtr, clLocPtr
3320: 2d 3e 6e 75 6d 2c 20 63 6c 4c 6f 63 50 74 72 2d ->num, clLocPtr-
3330: 3e 6c 6f 63 29 3b 0a 20 20 20 20 20 7d 0a 20 7d >loc);. }. }
3340: 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d 2d 2d 2d . .. /*. *-----
3350: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3360: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3370: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3380: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3390: 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c 43 6f 6e -. *. * TclCon
33a0: 74 69 6e 75 61 74 69 6f 6e 73 47 65 74 20 2d 2d tinuationsGet --
33b0: 0a 20 20 2a 0a 20 20 2a 09 54 68 69 73 20 70 72 . *. *.This pr
33c0: 6f 63 65 64 75 72 65 20 69 73 20 61 20 68 65 6c ocedure is a hel
33d0: 70 65 72 20 77 68 69 63 68 20 72 65 74 72 69 65 per which retrie
33e0: 76 65 73 20 74 68 65 20 63 6f 6e 74 69 6e 75 61 ves the continua
33f0: 74 69 6f 6e 20 6c 69 6e 65 0a 20 20 2a 09 69 6e tion line. *.in
3400: 66 6f 72 6d 61 74 69 6f 6e 20 61 73 73 6f 63 69 formation associ
3410: 61 74 65 64 20 77 69 74 68 20 61 20 54 63 6c 5f ated with a Tcl_
3420: 4f 62 6a 2a 2c 20 69 66 20 69 74 20 68 61 73 20 Obj*, if it has
3430: 61 6e 79 2e 0a 20 20 2a 0a 20 20 2a 20 52 65 73 any.. *. * Res
3440: 75 6c 74 73 3a 0a 20 20 2a 09 41 20 72 65 66 65 ults:. *.A refe
3450: 72 65 6e 63 65 20 74 6f 20 74 68 65 20 63 6f 6e rence to the con
3460: 74 69 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 20 6c tinuation line l
3470: 6f 63 61 74 69 6f 6e 20 74 61 62 6c 65 2c 20 6f ocation table, o
3480: 72 20 4e 55 4c 4c 20 69 66 20 74 68 65 0a 20 20 r NULL if the.
3490: 2a 09 54 63 6c 5f 4f 62 6a 2a 20 68 61 73 20 6e *.Tcl_Obj* has n
34a0: 6f 20 73 75 63 68 20 69 6e 66 6f 72 6d 61 74 69 o such informati
34b0: 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 on associated wi
34c0: 74 68 20 69 74 2e 0a 20 20 2a 0a 20 20 2a 20 53 th it.. *. * S
34d0: 69 64 65 20 65 66 66 65 63 74 73 3a 0a 20 20 2a ide effects:. *
34e0: 09 4e 6f 6e 65 2e 0a 20 20 2a 0a 20 20 2a 20 54 .None.. *. * T
34f0: 49 50 20 23 32 38 30 0a 20 20 2a 2d 2d 2d 2d 2d IP #280. *-----
3500: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3510: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3520: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3530: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3540: 2d 0a 20 20 2a 2f 0a 20 0a 20 43 6f 6e 74 4c 69 -. */. . ContLi
3550: 6e 65 4c 6f 63 20 2a 0a 20 54 63 6c 43 6f 6e 74 neLoc *. TclCont
3560: 69 6e 75 61 74 69 6f 6e 73 47 65 74 28 0a 20 20 inuationsGet(.
3570: 20 20 20 54 63 6c 5f 4f 62 6a 20 2a 6f 62 6a 50 Tcl_Obj *objP
3580: 74 72 29 0a 20 7b 0a 2d 20 20 20 20 54 68 72 65 tr). {.- Thre
3590: 61 64 53 70 65 63 69 66 69 63 44 61 74 61 20 2a adSpecificData *
35a0: 74 73 64 50 74 72 20 3d 20 54 63 6c 47 65 74 43 tsdPtr = TclGetC
35b0: 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 28 29 3b 0a ontLineTable();.
35c0: 2d 20 20 20 20 54 63 6c 5f 48 61 73 68 45 6e 74 - Tcl_HashEnt
35d0: 72 79 20 2a 68 50 74 72 20 3d 0a 2d 20 20 20 20 ry *hPtr =.-
35e0: 20 20 20 20 20 20 20 20 54 63 6c 5f 46 69 6e 64 Tcl_Find
35f0: 48 61 73 68 45 6e 74 72 79 28 74 73 64 50 74 72 HashEntry(tsdPtr
3600: 2d 3e 6c 69 6e 65 43 4c 50 74 72 2c 20 6f 62 6a ->lineCLPtr, obj
3610: 50 74 72 29 3b 0a 2b 20 20 20 20 54 63 6c 5f 48 Ptr);.+ Tcl_H
3620: 61 73 68 45 6e 74 72 79 20 2a 68 50 74 72 3b 0a ashEntry *hPtr;.
3630: 2b 20 20 20 20 54 63 6c 5f 48 61 73 68 54 61 62 + Tcl_HashTab
3640: 6c 65 20 2a 63 6f 6e 74 4c 69 6e 65 54 61 62 6c le *contLineTabl
3650: 65 20 3d 20 54 63 6c 47 65 74 43 6f 6e 74 4c 69 e = TclGetContLi
3660: 6e 65 54 61 62 6c 65 28 29 3b 0a 2b 20 20 20 20 neTable();.+
3670: 69 66 20 28 20 21 20 63 6f 6e 74 4c 69 6e 65 54 if ( ! contLineT
3680: 61 62 6c 65 20 29 0a 2b 20 20 20 20 20 20 20 20 able ).+
3690: 72 65 74 75 72 6e 20 4e 55 4c 4c 3b 0a 2b 0a 2b return NULL;.+.+
36a0: 20 20 20 20 68 50 74 72 20 3d 20 54 63 6c 5f 46 hPtr = Tcl_F
36b0: 69 6e 64 48 61 73 68 45 6e 74 72 79 28 63 6f 6e indHashEntry(con
36c0: 74 4c 69 6e 65 54 61 62 6c 65 2c 20 6f 62 6a 50 tLineTable, objP
36d0: 74 72 29 3b 0a 20 0a 20 20 20 20 20 69 66 20 28 tr);. . if (
36e0: 21 68 50 74 72 29 20 7b 0a 20 20 20 20 20 20 20 !hPtr) {.
36f0: 20 20 72 65 74 75 72 6e 20 4e 55 4c 4c 3b 0a 20 return NULL;.
3700: 20 20 20 20 7d 0a 20 20 20 20 20 72 65 74 75 72 }. retur
3710: 6e 20 54 63 6c 5f 47 65 74 48 61 73 68 56 61 6c n Tcl_GetHashVal
3720: 75 65 28 68 50 74 72 29 3b 0a 20 7d 0a 20 0c 0a ue(hPtr);. }. ..
3730: 20 2f 2a 0a 20 20 2a 2d 2d 2d 2d 2d 2d 2d 2d 2d /*. *---------
3740: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3750: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3760: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3770: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 -------------.
3780: 2a 0a 20 20 2a 20 54 63 6c 54 68 72 65 61 64 46 *. * TclThreadF
3790: 69 6e 61 6c 69 7a 65 43 6f 6e 74 4c 69 6e 65 73 inalizeContLines
37a0: 20 2d 2d 0a 20 20 2a 0a 20 20 2a 09 54 68 69 73 --. *. *.This
37b0: 20 70 72 6f 63 65 64 75 72 65 20 69 73 20 61 20 procedure is a
37c0: 68 65 6c 70 65 72 20 77 68 69 63 68 20 72 65 6c helper which rel
37d0: 65 61 73 65 73 20 61 6c 6c 20 63 6f 6e 74 69 6e eases all contin
37e0: 75 61 74 69 6f 6e 20 6c 69 6e 65 0a 20 20 2a 09 uation line. *.
37f0: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 63 75 72 72 information curr
3800: 65 6e 74 6c 79 20 6b 6e 6f 77 6e 2e 20 49 74 20 ently known. It
3810: 69 73 20 72 75 6e 20 61 73 20 61 20 74 68 72 65 is run as a thre
3820: 61 64 20 65 78 69 74 20 68 61 6e 64 6c 65 72 2e ad exit handler.
3830: 0a 20 20 2a 0a 20 20 2a 20 52 65 73 75 6c 74 73 . *. * Results
3840: 3a 0a 20 20 2a 09 4e 6f 6e 65 2e 0a 20 20 2a 0a :. *.None.. *.
3850: 20 20 2a 20 53 69 64 65 20 65 66 66 65 63 74 73 * Side effects
3860: 3a 0a 20 20 2a 09 52 65 6c 65 61 73 65 73 20 6d :. *.Releases m
3870: 65 6d 6f 72 79 2e 0a 20 20 2a 0a 20 20 2a 20 54 emory.. *. * T
3880: 49 50 20 23 32 38 30 0a 20 20 2a 2d 2d 2d 2d 2d IP #280. *-----
3890: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
38a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
38b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
38c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
38d0: 2d 0a 20 20 2a 2f 0a 20 0a 20 73 74 61 74 69 63 -. */. . static
38e0: 20 76 6f 69 64 0a 20 54 63 6c 54 68 72 65 61 64 void. TclThread
38f0: 46 69 6e 61 6c 69 7a 65 43 6f 6e 74 4c 69 6e 65 FinalizeContLine
3900: 73 28 0a 20 20 20 20 20 43 6c 69 65 6e 74 44 61 s(. ClientDa
3910: 74 61 20 63 6c 69 65 6e 74 44 61 74 61 29 0a 20 ta clientData).
3920: 7b 0a 20 20 20 20 20 2f 2a 0a 20 20 20 20 20 20 {. /*.
3930: 2a 20 52 65 6c 65 61 73 65 20 74 68 65 20 68 61 * Release the ha
3940: 73 68 74 61 62 6c 65 20 74 72 61 63 6b 69 6e 67 shtable tracking
3950: 20 69 6e 76 69 73 69 62 6c 65 20 63 6f 6e 74 69 invisible conti
3960: 6e 75 61 74 69 6f 6e 20 6c 69 6e 65 73 2e 0a 20 nuation lines..
3970: 20 20 20 20 20 2a 2f 0a 20 0a 2d 20 20 20 20 54 */. .- T
3980: 68 72 65 61 64 53 70 65 63 69 66 69 63 44 61 74 hreadSpecificDat
3990: 61 20 2a 74 73 64 50 74 72 20 3d 20 54 63 6c 47 a *tsdPtr = TclG
39a0: 65 74 43 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 28 etContLineTable(
39b0: 29 3b 0a 20 20 20 20 20 54 63 6c 5f 48 61 73 68 );. Tcl_Hash
39c0: 45 6e 74 72 79 20 2a 68 50 74 72 3b 0a 20 20 20 Entry *hPtr;.
39d0: 20 20 54 63 6c 5f 48 61 73 68 53 65 61 72 63 68 Tcl_HashSearch
39e0: 20 68 53 65 61 72 63 68 3b 0a 20 0a 2d 20 20 20 hSearch;. .-
39f0: 20 66 6f 72 20 28 68 50 74 72 20 3d 20 54 63 6c for (hPtr = Tcl
3a00: 5f 46 69 72 73 74 48 61 73 68 45 6e 74 72 79 28 _FirstHashEntry(
3a10: 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 4c 50 74 tsdPtr->lineCLPt
3a20: 72 2c 20 26 68 53 65 61 72 63 68 29 3b 0a 2b 20 r, &hSearch);.+
3a30: 20 20 20 54 63 6c 5f 48 61 73 68 54 61 62 6c 65 Tcl_HashTable
3a40: 20 2a 63 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 20 *contLineTable
3a50: 3d 20 54 63 6c 47 65 74 43 6f 6e 74 4c 69 6e 65 = TclGetContLine
3a60: 54 61 62 6c 65 28 29 3b 0a 2b 20 20 20 20 69 66 Table();.+ if
3a70: 20 28 20 21 20 63 6f 6e 74 4c 69 6e 65 54 61 62 ( ! contLineTab
3a80: 6c 65 20 29 0a 2b 20 20 20 20 20 20 20 20 72 65 le ).+ re
3a90: 74 75 72 6e 3b 0a 2b 0a 2b 20 20 20 20 66 6f 72 turn;.+.+ for
3aa0: 20 28 68 50 74 72 20 3d 20 54 63 6c 5f 46 69 72 (hPtr = Tcl_Fir
3ab0: 73 74 48 61 73 68 45 6e 74 72 79 28 63 6f 6e 74 stHashEntry(cont
3ac0: 4c 69 6e 65 54 61 62 6c 65 2c 20 26 68 53 65 61 LineTable, &hSea
3ad0: 72 63 68 29 3b 0a 20 09 20 20 20 20 68 50 74 72 rch);. . hPtr
3ae0: 20 21 3d 20 4e 55 4c 4c 3b 20 68 50 74 72 20 3d != NULL; hPtr =
3af0: 20 54 63 6c 5f 4e 65 78 74 48 61 73 68 45 6e 74 Tcl_NextHashEnt
3b00: 72 79 28 26 68 53 65 61 72 63 68 29 29 20 7b 0a ry(&hSearch)) {.
3b10: 20 09 54 63 6c 5f 46 72 65 65 28 54 63 6c 5f 47 .Tcl_Free(Tcl_G
3b20: 65 74 48 61 73 68 56 61 6c 75 65 28 68 50 74 72 etHashValue(hPtr
3b30: 29 29 3b 0a 20 09 54 63 6c 5f 44 65 6c 65 74 65 ));. .Tcl_Delete
3b40: 48 61 73 68 45 6e 74 72 79 28 68 50 74 72 29 3b HashEntry(hPtr);
3b50: 0a 20 20 20 20 20 7d 0a 2d 20 20 20 20 54 63 6c . }.- Tcl
3b60: 5f 44 65 6c 65 74 65 48 61 73 68 54 61 62 6c 65 _DeleteHashTable
3b70: 28 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 4c 50 (tsdPtr->lineCLP
3b80: 74 72 29 3b 0a 2d 20 20 20 20 54 63 6c 5f 46 72 tr);.- Tcl_Fr
3b90: 65 65 28 74 73 64 50 74 72 2d 3e 6c 69 6e 65 43 ee(tsdPtr->lineC
3ba0: 4c 50 74 72 29 3b 0a 2b 20 20 20 20 54 63 6c 5f LPtr);.+ Tcl_
3bb0: 44 65 6c 65 74 65 48 61 73 68 54 61 62 6c 65 28 DeleteHashTable(
3bc0: 63 6f 6e 74 4c 69 6e 65 54 61 62 6c 65 29 3b 0a contLineTable);.
3bd0: 2b 20 20 20 20 54 63 6c 5f 46 72 65 65 28 63 6f + Tcl_Free(co
3be0: 6e 74 4c 69 6e 65 54 61 62 6c 65 29 3b 0a 2b 20 ntLineTable);.+
3bf0: 20 20 20 7b 0a 2b 20 20 20 20 54 68 72 65 61 64 {.+ Thread
3c00: 53 70 65 63 69 66 69 63 44 61 74 61 20 2a 74 73 SpecificData *ts
3c10: 64 50 74 72 20 3d 20 54 43 4c 5f 54 53 44 5f 49 dPtr = TCL_TSD_I
3c20: 4e 49 54 28 26 64 61 74 61 4b 65 79 29 3b 0a 20 NIT(&dataKey);.
3c30: 20 20 20 20 74 73 64 50 74 72 2d 3e 6c 69 6e 65 tsdPtr->line
3c40: 43 4c 50 74 72 20 3d 20 4e 55 4c 4c 3b 0a 20 7d CLPtr = NULL;. }
3c50: 0a 2b 7d 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d .+}. .. /*. *--
3c60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3c70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3c80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3c90: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 20 2a ------------. *
3ca0: 0a 20 20 2a 20 54 63 6c 5f 52 65 67 69 73 74 65 . * Tcl_Registe
3cb0: 72 4f 62 6a 54 79 70 65 20 2d 2d 0a 20 20 2a 0a rObjType --. *.
3cc0: 20 20 2a 09 54 68 69 73 20 66 75 6e 63 74 69 6f *.This functio
3cd0: 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 72 n is called to r
3ce0: 65 67 69 73 74 65 72 20 61 20 6e 65 77 20 54 63 egister a new Tc
3cf0: 6c 20 6f 62 6a 65 63 74 20 74 79 70 65 20 69 6e l object type in
3d00: 20 74 68 65 20 74 61 62 6c 65 0a 20 20 2a 09 6f the table. *.o
3d10: 66 20 61 6c 6c 20 6f 62 6a 65 63 74 20 74 79 70 f all object typ
3d20: 65 73 20 73 75 70 70 6f 72 74 65 64 20 62 79 20 es supported by
3d30: 54 63 6c 2e 0a 20 20 2a 0a 20 20 2a 20 52 65 73 Tcl.. *. * Res
3d40: 75 6c 74 73 3a 0a 20 20 2a 09 4e 6f 6e 65 2e 0a ults:. *.None..
3d50: 20 20 2a 0a 20 20 2a 20 53 69 64 65 20 65 66 66 *. * Side eff
3d60: 65 63 74 73 3a 0a 20 20 2a 09 54 68 65 20 74 79 ects:. *.The ty
3d70: 70 65 20 69 73 20 72 65 67 69 73 74 65 72 65 64 pe is registered
3d80: 20 69 6e 20 74 68 65 20 54 63 6c 20 74 79 70 65 in the Tcl type
3d90: 20 74 61 62 6c 65 2e 20 49 66 20 74 68 65 72 65 table. If there
3da0: 20 77 61 73 20 61 6c 72 65 61 64 79 20 61 0a 20 was already a.
3db0: 20 2a 09 74 79 70 65 20 77 69 74 68 20 74 68 65 *.type with the
3dc0: 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 69 6e same name as in
3dd0: 20 74 79 70 65 50 74 72 2c 20 69 74 20 69 73 20 typePtr, it is
3de0: 72 65 70 6c 61 63 65 64 20 77 69 74 68 20 74 68 replaced with th
3df0: 65 20 6e 65 77 0a 20 20 2a 09 74 79 70 65 2e 0a e new. *.type..
3e00: 20 20 2a 0a 20 20 2a 2d 2d 2d 2d 2d 2d 2d 2d 2d *. *---------
3e10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3e20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3e30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3e40: 2d 2d 2d 2d 2d 0a 20 20 2a 2f 0a 20 0a 20 76 6f -----. */. . vo
3e50: 69 64 0a 20 54 63 6c 5f 52 65 67 69 73 74 65 72 id. Tcl_Register
3e60: 4f 62 6a 54 79 70 65 28 0a 20 20 20 20 20 63 6f ObjType(. co
3e70: 6e 73 74 20 54 63 6c 5f 4f 62 6a 54 79 70 65 20 nst Tcl_ObjType
3e80: 2a 74 79 70 65 50 74 72 29 09 2f 2a 20 49 6e 66 *typePtr)./* Inf
3e90: 6f 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 6f ormation about o
3ea0: 62 6a 65 63 74 20 74 79 70 65 3b 20 73 74 6f 72 bject type; stor
3eb0: 61 67 65 20 6d 75 73 74 0a 20 09 09 09 09 20 2a age must. .... *
3ec0: 20 62 65 20 73 74 61 74 69 63 61 6c 6c 79 20 61 be statically a
3ed0: 6c 6c 6f 63 61 74 65 64 20 28 6d 75 73 74 20 6c llocated (must l
3ee0: 69 76 65 0a 20 09 09 09 09 20 2a 20 66 6f 72 65 ive. .... * fore
3ef0: 76 65 72 29 2e 20 2a 2f 0a 20 7b 0a 20 20 20 20 ver). */. {.
3f00: 20 69 6e 74 20 69 73 4e 65 77 3b 0a 20 0a 20 20 int isNew;. .
3f10: 20 20 20 54 63 6c 5f 4d 75 74 65 78 4c 6f 63 6b Tcl_MutexLock
3f20: 28 26 74 61 62 6c 65 4d 75 74 65 78 29 3b 0a 20 (&tableMutex);.
3f30: 20 20 20 20 54 63 6c 5f 53 65 74 48 61 73 68 56 Tcl_SetHashV
3f40: 61 6c 75 65 28 0a 20 09 20 20 20 20 54 63 6c 5f alue(. . Tcl_
3f50: 43 72 65 61 74 65 48 61 73 68 45 6e 74 72 79 28 CreateHashEntry(
3f60: 26 74 79 70 65 54 61 62 6c 65 2c 20 74 79 70 65 &typeTable, type
3f70: 50 74 72 2d 3e 6e 61 6d 65 2c 20 26 69 73 4e 65 Ptr->name, &isNe
3f80: 77 29 2c 20 74 79 70 65 50 74 72 29 3b 0a 20 20 w), typePtr);.
3f90: 20 20 20 54 63 6c 5f 4d 75 74 65 78 55 6e 6c 6f Tcl_MutexUnlo
3fa0: 63 6b 28 26 74 61 62 6c 65 4d 75 74 65 78 29 3b ck(&tableMutex);
3fb0: 0a 20 7d 0a 20 0c 0a 20 2f 2a 0a 20 20 2a 2d 2d . }. .. /*. *--
3fc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3fd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3fe0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
3ff0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4000: 2d 2d 2d 2d 0a 20 20 2a 0a 20 20 2a 20 54 63 6c ----. *. * Tcl
4010: 5f 41 70 70 65 6e 64 41 6c 6c 4f 62 6a 54 79 70 _AppendAllObjTyp
4020: 65 73 20 2d 2d 0a 20 20 2a 0a 20 20 2a 09 54 68 es --. *. *.Th
4030: 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 70 70 65 is function appe
4040: 6e 64 73 20 6f 6e 74 6f 20 74 68 65 20 61 72 67 nds onto the arg
4050: 75 6d 65 6e 74 20 6f 62 6a 65 63 74 20 74 68 65 ument object the
4060: 20 6e 61 6d 65 20 6f 66 20 65 61 63 68 20 6f 62 name of each ob
4070: 6a 65 63 74 0a 20 20 2a 09 74 79 70 65 20 61 73 ject. *.type as
4080: 20 61 20 6c 69 73 74 20 65 6c 65 6d 65 6e 74 2e a list element.
4090: 20 54 68 69 73 20 69 6e 63 6c 75 64 65 73 20 74 This includes t
40a0: 68 65 20 62 75 69 6c 74 69 6e 20 6f 62 6a 65 63 he builtin objec
40b0: 74 20 74 79 70 65 73 20 28 65 2e 67 2e 0a 20 20 t types (e.g..
40c0: 2a 09 69 6e 74 2c 20 6c 69 73 74 29 20 61 73 20 *.int, list) as
40d0: 77 65 6c 6c 20 61 73 20 74 68 6f 73 65 20 61 64 well as those ad
40e0: 64 65 64 20 75 73 69 6e 67 20 54 63 6c 5f 4e 65 ded using Tcl_Ne
40f0: 77 4f 62 6a 2e 20 54 68 65 73 65 20 6e 61 6d 65 wObj. These name
4100: 73 20 63 61 6e 20 62 65 0a 20 20 2a 09 75 73 65 s can be. *.use
4110: 64 2c 20 66 6f 72 20 65 78 61 6d 70 6c 65 2c 20 d, for example,
4120: 77 69 74 68 20 54 63 6c 5f 47 65 74 4f 62 6a 54 with Tcl_GetObjT
4130: 79 70 65 20 74 6f 20 67 65 74 20 70 6f 69 6e 74 ype to get point
4140: 65 72 73 20 74 6f 20 74 68 65 0a 20 20 2a 09 63 ers to the. *.c
4150: 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 54 63 6c orresponding Tcl
4160: 5f 4f 62 6a 54 79 70 65 20 73 74 72 75 63 74 75 _ObjType structu
4170: 72 65 73 2e 0a 20 20 2a 0a 20 20 2a 20 52 65 73 res.. *. * Res
4180: 75 6c 74 73 3a 0a 20 20 2a 09 54 68 65 20 72 65 ults:. *.The re
4190: 74 75 72 6e 20 76 61 6c 75 65 20 69 73 20 6e 6f turn value is no
41a0: 72 6d 61 6c 6c 79 20 54 43 4c 5f 4f 4b 3b 20 69 rmally TCL_OK; i
41b0: 6e 20 74 68 69 73 20 63 61 73 65 20 74 68 65 20 n this case the
41c0: 6f 62 6a 65 63 74 0a 20 20 2a 09 72 65 66 65 72 object. *.refer
41d0: 65 6e 63 65 64 20 62 79 20 6f 62 6a 50 74 72 20 enced by objPtr
41e0: 68 61 73 20 65 61 63 68 20 74 79 70 65 20 6e 61 has each type na
41f0: 6d 65 20 61 70 70 65 6e 64 65 64 20 74 6f 20 69 me appended to i
4200: 74 2e 20 49 66 20 61 6e 20 65 72 72 6f 72 0a 20 t. If an error.
4210: 20 2a 09 6f 63 63 75 72 73 2c 20 54 43 4c 5f 45 *.occurs, TCL_E
4220: 52 52 4f 52 20 69 73 20 72 65 74 75 72 6e 65 64 RROR is returned
4230: 20 61 6e 64 20 74 68 65 20 69 6e 74 65 72 70 72 and the interpr
4240: 65 74 65 72 27 73 20 72 65 73 75 6c 74 20 68 6f eter's result ho
4250: 6c 64 73 20 61 6e 0a 20 20 2a 09 65 72 72 6f 72 lds an. *.error
4260: 20 6d 65 73 73 61 67 65 2e 0a 0a message...
