Attachment "dict-filter.c" to
ticket [2370575fff]
added by
dkf
2019-04-01 09:10:55.
0000: 0a 2f 2a 0a 20 2a 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ./*. *----------
0010: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0020: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0030: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0040: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 20 2a 0a ------------. *.
0050: 20 2a 20 44 69 63 74 46 69 6c 74 65 72 43 6d 64 * DictFilterCmd
0060: 20 2d 2d 0a 20 2a 0a 20 2a 09 54 68 69 73 20 66 --. *. *.This f
0070: 75 6e 63 74 69 6f 6e 20 69 6d 70 6c 65 6d 65 6e unction implemen
0080: 74 73 20 74 68 65 20 22 64 69 63 74 20 66 69 6c ts the "dict fil
0090: 74 65 72 22 20 54 63 6c 20 63 6f 6d 6d 61 6e 64 ter" Tcl command
00a0: 2e 20 53 65 65 20 74 68 65 20 75 73 65 72 0a 20 . See the user.
00b0: 2a 09 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 *.documentation
00c0: 66 6f 72 20 64 65 74 61 69 6c 73 20 6f 6e 20 77 for details on w
00d0: 68 61 74 20 69 74 20 64 6f 65 73 2c 20 61 6e 64 hat it does, and
00e0: 20 54 49 50 23 31 31 31 20 66 6f 72 20 74 68 65 TIP#111 for the
00f0: 20 66 6f 72 6d 61 6c 0a 20 2a 09 73 70 65 63 69 formal. *.speci
0100: 66 69 63 61 74 69 6f 6e 2e 0a 20 2a 0a 20 2a 20 fication.. *. *
0110: 52 65 73 75 6c 74 73 3a 0a 20 2a 09 41 20 73 74 Results:. *.A st
0120: 61 6e 64 61 72 64 20 54 63 6c 20 72 65 73 75 6c andard Tcl resul
0130: 74 2e 0a 20 2a 0a 20 2a 20 53 69 64 65 20 65 66 t.. *. * Side ef
0140: 66 65 63 74 73 3a 0a 20 2a 09 53 65 65 20 74 68 fects:. *.See th
0150: 65 20 75 73 65 72 20 64 6f 63 75 6d 65 6e 74 61 e user documenta
0160: 74 69 6f 6e 2e 0a 20 2a 0a 20 2a 2d 2d 2d 2d 2d tion.. *. *-----
0170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
0190: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
01a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
01b0: 2d 0a 20 2a 2f 0a 0a 73 74 61 74 69 63 20 69 6e -. */..static in
01c0: 74 0a 44 69 63 74 46 69 6c 74 65 72 43 6d 64 28 t.DictFilterCmd(
01d0: 0a 20 20 20 20 43 6c 69 65 6e 74 44 61 74 61 20 . ClientData
01e0: 64 75 6d 6d 79 2c 0a 20 20 20 20 54 63 6c 5f 49 dummy,. Tcl_I
01f0: 6e 74 65 72 70 20 2a 69 6e 74 65 72 70 2c 0a 20 nterp *interp,.
0200: 20 20 20 69 6e 74 20 6f 62 6a 63 2c 0a 20 20 20 int objc,.
0210: 20 54 63 6c 5f 4f 62 6a 20 2a 63 6f 6e 73 74 20 Tcl_Obj *const
0220: 2a 6f 62 6a 76 29 0a 7b 0a 20 20 20 20 49 6e 74 *objv).{. Int
0230: 65 72 70 20 2a 69 50 74 72 20 3d 20 28 49 6e 74 erp *iPtr = (Int
0240: 65 72 70 20 2a 29 20 69 6e 74 65 72 70 3b 0a 20 erp *) interp;.
0250: 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 static const
0260: 63 68 61 72 20 2a 63 6f 6e 73 74 20 66 69 6c 74 char *const filt
0270: 65 72 73 5b 5d 20 3d 20 7b 0a 09 22 6b 65 79 22 ers[] = {.."key"
0280: 2c 20 22 73 63 72 69 70 74 22 2c 20 22 76 61 6c , "script", "val
0290: 75 65 22 2c 20 4e 55 4c 4c 0a 20 20 20 20 7d 3b ue", NULL. };
02a0: 0a 20 20 20 20 65 6e 75 6d 20 46 69 6c 74 65 72 . enum Filter
02b0: 54 79 70 65 73 20 7b 0a 09 46 49 4c 54 45 52 5f Types {..FILTER_
02c0: 4b 45 59 53 2c 20 46 49 4c 54 45 52 5f 53 43 52 KEYS, FILTER_SCR
02d0: 49 50 54 2c 20 46 49 4c 54 45 52 5f 56 41 4c 55 IPT, FILTER_VALU
02e0: 45 53 0a 20 20 20 20 7d 3b 0a 20 20 20 20 54 63 ES. };. Tc
02f0: 6c 5f 4f 62 6a 20 2a 73 63 72 69 70 74 4f 62 6a l_Obj *scriptObj
0300: 2c 20 2a 6b 65 79 56 61 72 4f 62 6a 2c 20 2a 76 , *keyVarObj, *v
0310: 61 6c 75 65 56 61 72 4f 62 6a 3b 0a 20 20 20 20 alueVarObj;.
0320: 54 63 6c 5f 4f 62 6a 20 2a 2a 76 61 72 76 2c 20 Tcl_Obj **varv,
0330: 2a 6b 65 79 4f 62 6a 20 3d 20 4e 55 4c 4c 2c 20 *keyObj = NULL,
0340: 2a 76 61 6c 75 65 4f 62 6a 20 3d 20 4e 55 4c 4c *valueObj = NULL
0350: 2c 20 2a 72 65 73 75 6c 74 4f 62 6a 2c 20 2a 62 , *resultObj, *b
0360: 6f 6f 6c 4f 62 6a 3b 0a 20 20 20 20 54 63 6c 5f oolObj;. Tcl_
0370: 44 69 63 74 53 65 61 72 63 68 20 73 65 61 72 63 DictSearch searc
0380: 68 3b 0a 20 20 20 20 69 6e 74 20 69 6e 64 65 78 h;. int index
0390: 2c 20 76 61 72 63 2c 20 64 6f 6e 65 2c 20 72 65 , varc, done, re
03a0: 73 75 6c 74 2c 20 73 61 74 69 73 66 69 65 64 3b sult, satisfied;
03b0: 0a 0a 20 20 20 20 69 66 20 28 6f 62 6a 63 20 3c .. if (objc <
03c0: 20 33 29 20 7b 0a 09 54 63 6c 5f 57 72 6f 6e 67 3) {..Tcl_Wrong
03d0: 4e 75 6d 41 72 67 73 28 69 6e 74 65 72 70 2c 20 NumArgs(interp,
03e0: 31 2c 20 6f 62 6a 76 2c 20 22 64 69 63 74 69 6f 1, objv, "dictio
03f0: 6e 61 72 79 20 66 69 6c 74 65 72 54 79 70 65 20 nary filterType
0400: 3f 61 72 67 20 2e 2e 2e 3f 22 29 3b 0a 09 72 65 ?arg ...?");..re
0410: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a turn TCL_ERROR;.
0420: 20 20 20 20 7d 0a 20 20 20 20 69 66 20 28 54 63 }. if (Tc
0430: 6c 5f 47 65 74 49 6e 64 65 78 46 72 6f 6d 4f 62 l_GetIndexFromOb
0440: 6a 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 32 j(interp, objv[2
0450: 5d 2c 20 66 69 6c 74 65 72 73 2c 20 22 66 69 6c ], filters, "fil
0460: 74 65 72 54 79 70 65 22 2c 0a 09 20 20 20 20 20 terType",..
0470: 30 2c 20 26 69 6e 64 65 78 29 20 21 3d 20 54 43 0, &index) != TC
0480: 4c 5f 4f 4b 29 20 7b 0a 09 72 65 74 75 72 6e 20 L_OK) {..return
0490: 54 43 4c 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d TCL_ERROR;. }
04a0: 0a 0a 20 20 20 20 73 77 69 74 63 68 20 28 28 65 .. switch ((e
04b0: 6e 75 6d 20 46 69 6c 74 65 72 54 79 70 65 73 29 num FilterTypes)
04c0: 20 69 6e 64 65 78 29 20 7b 0a 20 20 20 20 63 61 index) {. ca
04d0: 73 65 20 46 49 4c 54 45 52 5f 4b 45 59 53 3a 0a se FILTER_KEYS:.
04e0: 0a 09 2f 2a 0a 09 20 2a 20 43 72 65 61 74 65 20 ../*.. * Create
04f0: 61 20 64 69 63 74 69 6f 6e 61 72 79 20 77 68 6f a dictionary who
0500: 73 65 20 6b 65 79 73 20 61 6c 6c 20 6d 61 74 63 se keys all matc
0510: 68 20 61 74 20 6c 65 61 73 74 20 6f 6e 65 20 0a h at least one .
0520: 09 20 2a 20 6f 66 20 74 68 65 20 67 69 76 65 6e . * of the given
0530: 20 70 61 74 74 65 72 6e 73 2e 0a 09 20 2a 2f 0a patterns... */.
0540: 0a 09 69 66 20 28 54 63 6c 5f 44 69 63 74 4f 62 ..if (Tcl_DictOb
0550: 6a 46 69 72 73 74 28 69 6e 74 65 72 70 2c 20 6f jFirst(interp, o
0560: 62 6a 76 5b 31 5d 2c 20 26 73 65 61 72 63 68 2c bjv[1], &search,
0570: 0a 09 09 26 6b 65 79 4f 62 6a 2c 20 26 76 61 6c ...&keyObj, &val
0580: 75 65 4f 62 6a 2c 20 26 64 6f 6e 65 29 20 21 3d ueObj, &done) !=
0590: 20 54 43 4c 5f 4f 4b 29 20 7b 0a 09 20 20 20 20 TCL_OK) {..
05a0: 72 65 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 return TCL_ERROR
05b0: 3b 0a 09 7d 0a 09 72 65 73 75 6c 74 4f 62 6a 20 ;..}..resultObj
05c0: 3d 20 54 63 6c 5f 4e 65 77 44 69 63 74 4f 62 6a = Tcl_NewDictObj
05d0: 28 29 3b 0a 09 77 68 69 6c 65 20 28 21 64 6f 6e ();..while (!don
05e0: 65 29 20 7b 0a 09 20 20 20 20 69 6e 74 20 69 64 e) {.. int id
05f0: 78 3b 0a 09 20 20 20 20 0a 09 20 20 20 20 66 6f x;.. .. fo
0600: 72 20 28 69 64 78 3d 33 3b 20 69 64 78 3c 6f 62 r (idx=3; idx<ob
0610: 6a 63 3b 20 69 64 78 2b 2b 29 20 7b 0a 09 09 69 jc; idx++) {...i
0620: 66 20 28 54 63 6c 5f 53 74 72 69 6e 67 4d 61 74 f (Tcl_StringMat
0630: 63 68 28 54 63 6c 47 65 74 53 74 72 69 6e 67 28 ch(TclGetString(
0640: 6b 65 79 4f 62 6a 29 2c 20 0a 09 09 09 54 63 6c keyObj), ....Tcl
0650: 47 65 74 53 74 72 69 6e 67 28 6f 62 6a 76 5b 69 GetString(objv[i
0660: 64 78 5d 29 29 29 20 7b 0a 09 09 20 20 20 20 54 dx]))) {... T
0670: 63 6c 5f 44 69 63 74 4f 62 6a 50 75 74 28 69 6e cl_DictObjPut(in
0680: 74 65 72 70 2c 20 72 65 73 75 6c 74 4f 62 6a 2c terp, resultObj,
0690: 20 6b 65 79 4f 62 6a 2c 20 76 61 6c 75 65 4f 62 keyObj, valueOb
06a0: 6a 29 3b 0a 09 09 20 20 20 20 62 72 65 61 6b 3b j);... break;
06b0: 0a 09 09 7d 0a 09 20 20 20 20 7d 0a 09 20 20 20 ...}.. }..
06c0: 20 54 63 6c 5f 44 69 63 74 4f 62 6a 4e 65 78 74 Tcl_DictObjNext
06d0: 28 26 73 65 61 72 63 68 2c 20 26 6b 65 79 4f 62 (&search, &keyOb
06e0: 6a 2c 20 26 76 61 6c 75 65 4f 62 6a 2c 20 26 64 j, &valueObj, &d
06f0: 6f 6e 65 29 3b 0a 09 7d 0a 09 54 63 6c 5f 53 65 one);..}..Tcl_Se
0700: 74 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 tObjResult(inter
0710: 70 2c 20 72 65 73 75 6c 74 4f 62 6a 29 3b 0a 09 p, resultObj);..
0720: 72 65 74 75 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 0a return TCL_OK;..
0730: 20 20 20 20 63 61 73 65 20 46 49 4c 54 45 52 5f case FILTER_
0740: 56 41 4c 55 45 53 3a 0a 0a 09 2f 2a 0a 09 20 2a VALUES:.../*.. *
0750: 20 43 72 65 61 74 65 20 61 20 64 69 63 74 69 6f Create a dictio
0760: 6e 61 72 79 20 77 68 6f 73 65 20 76 61 6c 75 65 nary whose value
0770: 73 20 61 6c 6c 20 6d 61 74 63 68 20 61 74 20 6c s all match at l
0780: 65 61 73 74 20 6f 6e 65 20 0a 09 20 2a 20 6f 66 east one .. * of
0790: 20 74 68 65 20 67 69 76 65 6e 20 70 61 74 74 65 the given patte
07a0: 72 6e 73 2e 0a 09 20 2a 2f 0a 0a 09 69 66 20 28 rns... */...if (
07b0: 54 63 6c 5f 44 69 63 74 4f 62 6a 46 69 72 73 74 Tcl_DictObjFirst
07c0: 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b 31 5d (interp, objv[1]
07d0: 2c 20 26 73 65 61 72 63 68 2c 0a 09 09 26 6b 65 , &search,...&ke
07e0: 79 4f 62 6a 2c 20 26 76 61 6c 75 65 4f 62 6a 2c yObj, &valueObj,
07f0: 20 26 64 6f 6e 65 29 20 21 3d 20 54 43 4c 5f 4f &done) != TCL_O
0800: 4b 29 20 7b 0a 09 20 20 20 20 72 65 74 75 72 6e K) {.. return
0810: 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 09 7d 0a 09 TCL_ERROR;..}..
0820: 72 65 73 75 6c 74 4f 62 6a 20 3d 20 54 63 6c 5f resultObj = Tcl_
0830: 4e 65 77 44 69 63 74 4f 62 6a 28 29 3b 0a 09 77 NewDictObj();..w
0840: 68 69 6c 65 20 28 21 64 6f 6e 65 29 20 7b 0a 09 hile (!done) {..
0850: 20 20 20 20 69 6e 74 20 69 64 78 3b 0a 09 20 20 int idx;..
0860: 20 20 0a 09 20 20 20 20 66 6f 72 20 28 69 64 78 .. for (idx
0870: 3d 33 3b 20 69 64 78 3c 6f 62 6a 63 3b 20 69 64 =3; idx<objc; id
0880: 78 2b 2b 29 20 7b 0a 09 09 69 66 20 28 54 63 6c x++) {...if (Tcl
0890: 5f 53 74 72 69 6e 67 4d 61 74 63 68 28 54 63 6c _StringMatch(Tcl
08a0: 47 65 74 53 74 72 69 6e 67 28 76 61 6c 75 65 4f GetString(valueO
08b0: 62 6a 29 2c 20 0a 09 09 09 54 63 6c 47 65 74 53 bj), ....TclGetS
08c0: 74 72 69 6e 67 28 6f 62 6a 76 5b 69 64 78 5d 29 tring(objv[idx])
08d0: 29 29 20 7b 0a 09 09 20 20 20 20 54 63 6c 5f 44 )) {... Tcl_D
08e0: 69 63 74 4f 62 6a 50 75 74 28 69 6e 74 65 72 70 ictObjPut(interp
08f0: 2c 20 72 65 73 75 6c 74 4f 62 6a 2c 20 6b 65 79 , resultObj, key
0900: 4f 62 6a 2c 20 76 61 6c 75 65 4f 62 6a 29 3b 0a Obj, valueObj);.
0910: 09 09 20 20 20 20 62 72 65 61 6b 3b 0a 09 09 7d .. break;...}
0920: 0a 09 20 20 20 20 7d 0a 09 20 20 20 20 54 63 6c .. }.. Tcl
0930: 5f 44 69 63 74 4f 62 6a 4e 65 78 74 28 26 73 65 _DictObjNext(&se
0940: 61 72 63 68 2c 20 26 6b 65 79 4f 62 6a 2c 20 26 arch, &keyObj, &
0950: 76 61 6c 75 65 4f 62 6a 2c 20 26 64 6f 6e 65 29 valueObj, &done)
0960: 3b 0a 09 7d 0a 09 54 63 6c 5f 53 65 74 4f 62 6a ;..}..Tcl_SetObj
0970: 52 65 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 72 Result(interp, r
0980: 65 73 75 6c 74 4f 62 6a 29 3b 0a 09 72 65 74 75 esultObj);..retu
0990: 72 6e 20 54 43 4c 5f 4f 4b 3b 0a 0a 20 20 20 20 rn TCL_OK;..
09a0: 63 61 73 65 20 46 49 4c 54 45 52 5f 53 43 52 49 case FILTER_SCRI
09b0: 50 54 3a 0a 09 69 66 20 28 6f 62 6a 63 20 21 3d PT:..if (objc !=
09c0: 20 35 29 20 7b 0a 09 20 20 20 20 54 63 6c 5f 57 5) {.. Tcl_W
09d0: 72 6f 6e 67 4e 75 6d 41 72 67 73 28 69 6e 74 65 rongNumArgs(inte
09e0: 72 70 2c 20 31 2c 20 6f 62 6a 76 2c 0a 09 09 20 rp, 1, objv,...
09f0: 20 20 20 22 64 69 63 74 69 6f 6e 61 72 79 20 73 "dictionary s
0a00: 63 72 69 70 74 20 7b 6b 65 79 56 61 72 20 76 61 cript {keyVar va
0a10: 6c 75 65 56 61 72 7d 20 66 69 6c 74 65 72 53 63 lueVar} filterSc
0a20: 72 69 70 74 22 29 3b 0a 09 20 20 20 20 72 65 74 ript");.. ret
0a30: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 09 urn TCL_ERROR;..
0a40: 7d 0a 0a 09 2f 2a 0a 09 20 2a 20 43 72 65 61 74 }.../*.. * Creat
0a50: 65 20 61 20 64 69 63 74 69 6f 6e 61 72 79 20 77 e a dictionary w
0a60: 68 6f 73 65 20 6b 65 79 2c 76 61 6c 75 65 20 70 hose key,value p
0a70: 61 69 72 73 20 61 6c 6c 20 73 61 74 69 73 66 79 airs all satisfy
0a80: 20 61 20 73 63 72 69 70 74 0a 09 20 2a 20 28 69 a script.. * (i
0a90: 2e 65 2e 20 67 65 74 20 61 20 74 72 75 65 20 62 .e. get a true b
0aa0: 6f 6f 6c 65 61 6e 20 72 65 73 75 6c 74 20 66 72 oolean result fr
0ab0: 6f 6d 20 69 74 73 20 65 76 61 6c 75 61 74 69 6f om its evaluatio
0ac0: 6e 29 2e 20 4d 61 73 73 69 76 65 0a 09 20 2a 20 n). Massive.. *
0ad0: 63 6f 70 79 69 6e 67 20 66 72 6f 6d 20 74 68 65 copying from the
0ae0: 20 22 64 69 63 74 20 66 6f 72 22 20 69 6d 70 6c "dict for" impl
0af0: 65 6d 65 6e 74 61 74 69 6f 6e 20 68 61 73 20 6f ementation has o
0b00: 63 63 75 72 72 65 64 21 0a 09 20 2a 2f 0a 0a 09 ccurred!.. */...
0b10: 69 66 20 28 54 63 6c 4c 69 73 74 4f 62 6a 47 65 if (TclListObjGe
0b20: 74 45 6c 65 6d 65 6e 74 73 28 69 6e 74 65 72 70 tElements(interp
0b30: 2c 20 6f 62 6a 76 5b 33 5d 2c 20 26 76 61 72 63 , objv[3], &varc
0b40: 2c 20 26 76 61 72 76 29 20 21 3d 20 54 43 4c 5f , &varv) != TCL_
0b50: 4f 4b 29 20 7b 0a 09 20 20 20 20 72 65 74 75 72 OK) {.. retur
0b60: 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 09 7d 0a n TCL_ERROR;..}.
0b70: 09 69 66 20 28 76 61 72 63 20 21 3d 20 32 29 20 .if (varc != 2)
0b80: 7b 0a 09 20 20 20 20 54 63 6c 5f 53 65 74 52 65 {.. Tcl_SetRe
0b90: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 22 6d 75 sult(interp, "mu
0ba0: 73 74 20 68 61 76 65 20 65 78 61 63 74 6c 79 20 st have exactly
0bb0: 74 77 6f 20 76 61 72 69 61 62 6c 65 20 6e 61 6d two variable nam
0bc0: 65 73 22 2c 0a 09 09 20 20 20 20 54 43 4c 5f 53 es",... TCL_S
0bd0: 54 41 54 49 43 29 3b 0a 09 20 20 20 20 72 65 74 TATIC);.. ret
0be0: 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 09 urn TCL_ERROR;..
0bf0: 7d 0a 09 6b 65 79 56 61 72 4f 62 6a 20 3d 20 76 }..keyVarObj = v
0c00: 61 72 76 5b 30 5d 3b 0a 09 76 61 6c 75 65 56 61 arv[0];..valueVa
0c10: 72 4f 62 6a 20 3d 20 76 61 72 76 5b 31 5d 3b 0a rObj = varv[1];.
0c20: 09 73 63 72 69 70 74 4f 62 6a 20 3d 20 6f 62 6a .scriptObj = obj
0c30: 76 5b 34 5d 3b 0a 0a 09 2f 2a 0a 09 20 2a 20 4d v[4];.../*.. * M
0c40: 61 6b 65 20 73 75 72 65 20 74 68 61 74 20 74 68 ake sure that th
0c50: 65 73 65 20 6f 62 6a 65 63 74 73 20 28 77 68 69 ese objects (whi
0c60: 63 68 20 77 65 20 6e 65 65 64 20 74 68 72 6f 75 ch we need throu
0c70: 67 68 6f 75 74 20 74 68 65 20 62 6f 64 79 20 6f ghout the body o
0c80: 66 0a 09 20 2a 20 74 68 65 20 6c 6f 6f 70 29 20 f.. * the loop)
0c90: 64 6f 6e 27 74 20 76 61 6e 69 73 68 2e 20 4e 6f don't vanish. No
0ca0: 74 65 20 74 68 61 74 20 74 68 65 20 64 69 63 74 te that the dict
0cb0: 69 6f 6e 61 72 79 20 69 6e 74 65 72 6e 61 6c 20 ionary internal
0cc0: 72 65 70 20 69 73 0a 09 20 2a 20 6c 6f 63 6b 65 rep is.. * locke
0cd0: 64 20 69 6e 74 65 72 6e 61 6c 6c 79 20 73 6f 20 d internally so
0ce0: 74 68 61 74 20 75 70 64 61 74 65 73 2c 20 73 68 that updates, sh
0cf0: 69 6d 6d 65 72 69 6e 67 2c 20 65 74 63 20 61 72 immering, etc ar
0d00: 65 20 6e 6f 74 20 61 0a 09 20 2a 20 70 72 6f 62 e not a.. * prob
0d10: 6c 65 6d 2e 0a 09 20 2a 2f 0a 0a 09 54 63 6c 5f lem... */...Tcl_
0d20: 49 6e 63 72 52 65 66 43 6f 75 6e 74 28 6b 65 79 IncrRefCount(key
0d30: 56 61 72 4f 62 6a 29 3b 0a 09 54 63 6c 5f 49 6e VarObj);..Tcl_In
0d40: 63 72 52 65 66 43 6f 75 6e 74 28 76 61 6c 75 65 crRefCount(value
0d50: 56 61 72 4f 62 6a 29 3b 0a 09 54 63 6c 5f 49 6e VarObj);..Tcl_In
0d60: 63 72 52 65 66 43 6f 75 6e 74 28 73 63 72 69 70 crRefCount(scrip
0d70: 74 4f 62 6a 29 3b 0a 0a 09 72 65 73 75 6c 74 20 tObj);...result
0d80: 3d 20 54 63 6c 5f 44 69 63 74 4f 62 6a 46 69 72 = Tcl_DictObjFir
0d90: 73 74 28 69 6e 74 65 72 70 2c 20 6f 62 6a 76 5b st(interp, objv[
0da0: 31 5d 2c 0a 09 09 26 73 65 61 72 63 68 2c 20 26 1],...&search, &
0db0: 6b 65 79 4f 62 6a 2c 20 26 76 61 6c 75 65 4f 62 keyObj, &valueOb
0dc0: 6a 2c 20 26 64 6f 6e 65 29 3b 0a 09 69 66 20 28 j, &done);..if (
0dd0: 72 65 73 75 6c 74 20 21 3d 20 54 43 4c 5f 4f 4b result != TCL_OK
0de0: 29 20 7b 0a 09 20 20 20 20 54 63 6c 44 65 63 72 ) {.. TclDecr
0df0: 52 65 66 43 6f 75 6e 74 28 6b 65 79 56 61 72 4f RefCount(keyVarO
0e00: 62 6a 29 3b 0a 09 20 20 20 20 54 63 6c 44 65 63 bj);.. TclDec
0e10: 72 52 65 66 43 6f 75 6e 74 28 76 61 6c 75 65 56 rRefCount(valueV
0e20: 61 72 4f 62 6a 29 3b 0a 09 20 20 20 20 54 63 6c arObj);.. Tcl
0e30: 44 65 63 72 52 65 66 43 6f 75 6e 74 28 73 63 72 DecrRefCount(scr
0e40: 69 70 74 4f 62 6a 29 3b 0a 09 20 20 20 20 72 65 iptObj);.. re
0e50: 74 75 72 6e 20 54 43 4c 5f 45 52 52 4f 52 3b 0a turn TCL_ERROR;.
0e60: 09 7d 0a 0a 09 72 65 73 75 6c 74 4f 62 6a 20 3d .}...resultObj =
0e70: 20 54 63 6c 5f 4e 65 77 44 69 63 74 4f 62 6a 28 Tcl_NewDictObj(
0e80: 29 3b 0a 0a 09 77 68 69 6c 65 20 28 21 64 6f 6e );...while (!don
0e90: 65 29 20 7b 0a 09 20 20 20 20 2f 2a 0a 09 20 20 e) {.. /*..
0ea0: 20 20 20 2a 20 53 74 6f 70 20 74 68 65 20 76 61 * Stop the va
0eb0: 6c 75 65 20 66 72 6f 6d 20 67 65 74 74 69 6e 67 lue from getting
0ec0: 20 68 69 74 20 69 6e 20 61 6e 79 20 77 61 79 20 hit in any way
0ed0: 62 79 20 61 6e 79 20 74 72 61 63 65 73 20 6f 6e by any traces on
0ee0: 20 74 68 65 0a 09 20 20 20 20 20 2a 20 6b 65 79 the.. * key
0ef0: 20 76 61 72 69 61 62 6c 65 2e 0a 09 20 20 20 20 variable...
0f00: 20 2a 2f 0a 0a 09 20 20 20 20 54 63 6c 5f 49 6e */... Tcl_In
0f10: 63 72 52 65 66 43 6f 75 6e 74 28 6b 65 79 4f 62 crRefCount(keyOb
0f20: 6a 29 3b 0a 09 20 20 20 20 54 63 6c 5f 49 6e 63 j);.. Tcl_Inc
0f30: 72 52 65 66 43 6f 75 6e 74 28 76 61 6c 75 65 4f rRefCount(valueO
0f40: 62 6a 29 3b 0a 09 20 20 20 20 69 66 20 28 54 63 bj);.. if (Tc
0f50: 6c 5f 4f 62 6a 53 65 74 56 61 72 32 28 69 6e 74 l_ObjSetVar2(int
0f60: 65 72 70 2c 20 6b 65 79 56 61 72 4f 62 6a 2c 20 erp, keyVarObj,
0f70: 4e 55 4c 4c 2c 20 6b 65 79 4f 62 6a 2c 0a 09 09 NULL, keyObj,...
0f80: 20 20 20 20 54 43 4c 5f 4c 45 41 56 45 5f 45 52 TCL_LEAVE_ER
0f90: 52 5f 4d 53 47 29 20 3d 3d 20 4e 55 4c 4c 29 20 R_MSG) == NULL)
0fa0: 7b 0a 09 09 54 63 6c 5f 52 65 73 65 74 52 65 73 {...Tcl_ResetRes
0fb0: 75 6c 74 28 69 6e 74 65 72 70 29 3b 0a 09 09 54 ult(interp);...T
0fc0: 63 6c 5f 41 70 70 65 6e 64 52 65 73 75 6c 74 28 cl_AppendResult(
0fd0: 69 6e 74 65 72 70 2c 20 22 63 6f 75 6c 64 6e 27 interp, "couldn'
0fe0: 74 20 73 65 74 20 6b 65 79 20 76 61 72 69 61 62 t set key variab
0ff0: 6c 65 3a 20 5c 22 22 2c 0a 09 09 09 54 63 6c 47 le: \"",....TclG
1000: 65 74 53 74 72 69 6e 67 28 6b 65 79 56 61 72 4f etString(keyVarO
1010: 62 6a 29 2c 20 22 5c 22 22 2c 20 4e 55 4c 4c 29 bj), "\"", NULL)
1020: 3b 0a 09 09 72 65 73 75 6c 74 20 3d 20 54 43 4c ;...result = TCL
1030: 5f 45 52 52 4f 52 3b 0a 09 09 67 6f 74 6f 20 61 _ERROR;...goto a
1040: 62 6e 6f 72 6d 61 6c 52 65 73 75 6c 74 3b 0a 09 bnormalResult;..
1050: 20 20 20 20 7d 0a 09 20 20 20 20 69 66 20 28 54 }.. if (T
1060: 63 6c 5f 4f 62 6a 53 65 74 56 61 72 32 28 69 6e cl_ObjSetVar2(in
1070: 74 65 72 70 2c 20 76 61 6c 75 65 56 61 72 4f 62 terp, valueVarOb
1080: 6a 2c 20 4e 55 4c 4c 2c 20 76 61 6c 75 65 4f 62 j, NULL, valueOb
1090: 6a 2c 0a 09 09 20 20 20 20 54 43 4c 5f 4c 45 41 j,... TCL_LEA
10a0: 56 45 5f 45 52 52 5f 4d 53 47 29 20 3d 3d 20 4e VE_ERR_MSG) == N
10b0: 55 4c 4c 29 20 7b 0a 09 09 54 63 6c 5f 52 65 73 ULL) {...Tcl_Res
10c0: 65 74 52 65 73 75 6c 74 28 69 6e 74 65 72 70 29 etResult(interp)
10d0: 3b 0a 09 09 54 63 6c 5f 41 70 70 65 6e 64 52 65 ;...Tcl_AppendRe
10e0: 73 75 6c 74 28 69 6e 74 65 72 70 2c 20 22 63 6f sult(interp, "co
10f0: 75 6c 64 6e 27 74 20 73 65 74 20 76 61 6c 75 65 uldn't set value
1100: 20 76 61 72 69 61 62 6c 65 3a 20 5c 22 22 2c 0a variable: \"",.
1110: 09 09 09 54 63 6c 47 65 74 53 74 72 69 6e 67 28 ...TclGetString(
1120: 76 61 6c 75 65 56 61 72 4f 62 6a 29 2c 20 22 5c valueVarObj), "\
1130: 22 22 2c 20 4e 55 4c 4c 29 3b 0a 09 09 67 6f 74 "", NULL);...got
1140: 6f 20 61 62 6e 6f 72 6d 61 6c 52 65 73 75 6c 74 o abnormalResult
1150: 3b 0a 09 20 20 20 20 7d 0a 0a 09 20 20 20 20 2f ;.. }... /
1160: 2a 0a 09 20 20 20 20 20 2a 20 54 49 50 20 23 32 *.. * TIP #2
1170: 38 30 2e 20 4d 61 6b 65 20 69 6e 76 6f 6b 69 6e 80. Make invokin
1180: 67 20 63 6f 6e 74 65 78 74 20 61 76 61 69 6c 61 g context availa
1190: 62 6c 65 20 74 6f 20 6c 6f 6f 70 20 62 6f 64 79 ble to loop body
11a0: 2e 0a 09 20 20 20 20 20 2a 2f 0a 0a 09 20 20 20 ... */...
11b0: 20 72 65 73 75 6c 74 20 3d 20 54 63 6c 45 76 61 result = TclEva
11c0: 6c 4f 62 6a 45 78 28 69 6e 74 65 72 70 2c 20 73 lObjEx(interp, s
11d0: 63 72 69 70 74 4f 62 6a 2c 20 30 2c 20 69 50 74 criptObj, 0, iPt
11e0: 72 2d 3e 63 6d 64 46 72 61 6d 65 50 74 72 2c 20 r->cmdFramePtr,
11f0: 34 29 3b 0a 09 20 20 20 20 73 77 69 74 63 68 20 4);.. switch
1200: 28 72 65 73 75 6c 74 29 20 7b 0a 09 20 20 20 20 (result) {..
1210: 63 61 73 65 20 54 43 4c 5f 4f 4b 3a 0a 09 09 62 case TCL_OK:...b
1220: 6f 6f 6c 4f 62 6a 20 3d 20 54 63 6c 5f 47 65 74 oolObj = Tcl_Get
1230: 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 70 ObjResult(interp
1240: 29 3b 0a 09 09 54 63 6c 5f 49 6e 63 72 52 65 66 );...Tcl_IncrRef
1250: 43 6f 75 6e 74 28 62 6f 6f 6c 4f 62 6a 29 3b 0a Count(boolObj);.
1260: 09 09 54 63 6c 5f 52 65 73 65 74 52 65 73 75 6c ..Tcl_ResetResul
1270: 74 28 69 6e 74 65 72 70 29 3b 0a 09 09 69 66 20 t(interp);...if
1280: 28 54 63 6c 5f 47 65 74 42 6f 6f 6c 65 61 6e 46 (Tcl_GetBooleanF
1290: 72 6f 6d 4f 62 6a 28 69 6e 74 65 72 70 2c 20 62 romObj(interp, b
12a0: 6f 6f 6c 4f 62 6a 2c 0a 09 09 09 26 73 61 74 69 oolObj,....&sati
12b0: 73 66 69 65 64 29 20 21 3d 20 54 43 4c 5f 4f 4b sfied) != TCL_OK
12c0: 29 20 7b 0a 09 09 20 20 20 20 54 63 6c 44 65 63 ) {... TclDec
12d0: 72 52 65 66 43 6f 75 6e 74 28 62 6f 6f 6c 4f 62 rRefCount(boolOb
12e0: 6a 29 3b 0a 09 09 20 20 20 20 72 65 73 75 6c 74 j);... result
12f0: 20 3d 20 54 43 4c 5f 45 52 52 4f 52 3b 0a 09 09 = TCL_ERROR;...
1300: 20 20 20 20 67 6f 74 6f 20 61 62 6e 6f 72 6d 61 goto abnorma
1310: 6c 52 65 73 75 6c 74 3b 0a 09 09 7d 0a 09 09 54 lResult;...}...T
1320: 63 6c 44 65 63 72 52 65 66 43 6f 75 6e 74 28 62 clDecrRefCount(b
1330: 6f 6f 6c 4f 62 6a 29 3b 0a 09 09 69 66 20 28 73 oolObj);...if (s
1340: 61 74 69 73 66 69 65 64 29 20 7b 0a 09 09 20 20 atisfied) {...
1350: 20 20 54 63 6c 5f 44 69 63 74 4f 62 6a 50 75 74 Tcl_DictObjPut
1360: 28 69 6e 74 65 72 70 2c 20 72 65 73 75 6c 74 4f (interp, resultO
1370: 62 6a 2c 20 6b 65 79 4f 62 6a 2c 20 76 61 6c 75 bj, keyObj, valu
1380: 65 4f 62 6a 29 3b 0a 09 09 7d 0a 09 09 62 72 65 eObj);...}...bre
1390: 61 6b 3b 0a 09 20 20 20 20 63 61 73 65 20 54 43 ak;.. case TC
13a0: 4c 5f 42 52 45 41 4b 3a 0a 09 09 2f 2a 0a 09 09 L_BREAK:.../*...
13b0: 20 2a 20 46 6f 72 63 65 20 6c 6f 6f 70 20 74 65 * Force loop te
13c0: 72 6d 69 6e 61 74 69 6f 6e 20 62 79 20 63 61 6c rmination by cal
13d0: 6c 69 6e 67 20 54 63 6c 5f 44 69 63 74 4f 62 6a ling Tcl_DictObj
13e0: 44 6f 6e 65 3b 20 74 68 69 73 0a 09 09 20 2a 20 Done; this... *
13f0: 6d 61 6b 65 73 20 74 68 65 20 6e 65 78 74 20 54 makes the next T
1400: 63 6c 5f 44 69 63 74 4f 62 6a 4e 65 78 74 20 73 cl_DictObjNext s
1410: 61 79 20 74 68 65 72 65 20 69 73 20 6e 6f 74 68 ay there is noth
1420: 69 6e 67 20 6d 6f 72 65 20 74 6f 0a 09 09 20 2a ing more to... *
1430: 20 64 6f 2e 0a 09 09 20 2a 2f 0a 0a 09 09 54 63 do.... */....Tc
1440: 6c 5f 52 65 73 65 74 52 65 73 75 6c 74 28 69 6e l_ResetResult(in
1450: 74 65 72 70 29 3b 0a 09 09 54 63 6c 5f 44 69 63 terp);...Tcl_Dic
1460: 74 4f 62 6a 44 6f 6e 65 28 26 73 65 61 72 63 68 tObjDone(&search
1470: 29 3b 0a 09 20 20 20 20 63 61 73 65 20 54 43 4c );.. case TCL
1480: 5f 43 4f 4e 54 49 4e 55 45 3a 0a 09 09 72 65 73 _CONTINUE:...res
1490: 75 6c 74 20 3d 20 54 43 4c 5f 4f 4b 3b 0a 09 09 ult = TCL_OK;...
14a0: 62 72 65 61 6b 3b 0a 09 20 20 20 20 63 61 73 65 break;.. case
14b0: 20 54 43 4c 5f 45 52 52 4f 52 3a 0a 09 09 54 63 TCL_ERROR:...Tc
14c0: 6c 5f 41 70 70 65 6e 64 4f 62 6a 54 6f 45 72 72 l_AppendObjToErr
14d0: 6f 72 49 6e 66 6f 28 69 6e 74 65 72 70 2c 20 54 orInfo(interp, T
14e0: 63 6c 5f 4f 62 6a 50 72 69 6e 74 66 28 0a 09 09 cl_ObjPrintf(...
14f0: 09 22 5c 6e 20 20 20 20 28 5c 22 64 69 63 74 20 ."\n (\"dict
1500: 66 69 6c 74 65 72 5c 22 20 73 63 72 69 70 74 20 filter\" script
1510: 6c 69 6e 65 20 25 64 29 22 2c 0a 09 09 09 69 6e line %d)",....in
1520: 74 65 72 70 2d 3e 65 72 72 6f 72 4c 69 6e 65 29 terp->errorLine)
1530: 29 3b 0a 09 20 20 20 20 64 65 66 61 75 6c 74 3a );.. default:
1540: 0a 09 09 67 6f 74 6f 20 61 62 6e 6f 72 6d 61 6c ...goto abnormal
1550: 52 65 73 75 6c 74 3b 0a 09 20 20 20 20 7d 0a 0a Result;.. }..
1560: 09 20 20 20 20 54 63 6c 44 65 63 72 52 65 66 43 . TclDecrRefC
1570: 6f 75 6e 74 28 6b 65 79 4f 62 6a 29 3b 0a 09 20 ount(keyObj);..
1580: 20 20 20 54 63 6c 44 65 63 72 52 65 66 43 6f 75 TclDecrRefCou
1590: 6e 74 28 76 61 6c 75 65 4f 62 6a 29 3b 0a 0a 09 nt(valueObj);...
15a0: 20 20 20 20 54 63 6c 5f 44 69 63 74 4f 62 6a 4e Tcl_DictObjN
15b0: 65 78 74 28 26 73 65 61 72 63 68 2c 20 26 6b 65 ext(&search, &ke
15c0: 79 4f 62 6a 2c 20 26 76 61 6c 75 65 4f 62 6a 2c yObj, &valueObj,
15d0: 20 26 64 6f 6e 65 29 3b 0a 09 7d 0a 0a 09 2f 2a &done);..}.../*
15e0: 0a 09 20 2a 20 53 74 6f 70 20 68 6f 6c 64 69 6e .. * Stop holdin
15f0: 67 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f g a reference to
1600: 20 74 68 65 73 65 20 6f 62 6a 65 63 74 73 2e 0a these objects..
1610: 09 20 2a 2f 0a 0a 09 54 63 6c 44 65 63 72 52 65 . */...TclDecrRe
1620: 66 43 6f 75 6e 74 28 6b 65 79 56 61 72 4f 62 6a fCount(keyVarObj
1630: 29 3b 0a 09 54 63 6c 44 65 63 72 52 65 66 43 6f );..TclDecrRefCo
1640: 75 6e 74 28 76 61 6c 75 65 56 61 72 4f 62 6a 29 unt(valueVarObj)
1650: 3b 0a 09 54 63 6c 44 65 63 72 52 65 66 43 6f 75 ;..TclDecrRefCou
1660: 6e 74 28 73 63 72 69 70 74 4f 62 6a 29 3b 0a 09 nt(scriptObj);..
1670: 54 63 6c 5f 44 69 63 74 4f 62 6a 44 6f 6e 65 28 Tcl_DictObjDone(
1680: 26 73 65 61 72 63 68 29 3b 0a 0a 09 69 66 20 28 &search);...if (
1690: 72 65 73 75 6c 74 20 3d 3d 20 54 43 4c 5f 4f 4b result == TCL_OK
16a0: 29 20 7b 0a 09 20 20 20 20 54 63 6c 5f 53 65 74 ) {.. Tcl_Set
16b0: 4f 62 6a 52 65 73 75 6c 74 28 69 6e 74 65 72 70 ObjResult(interp
16c0: 2c 20 72 65 73 75 6c 74 4f 62 6a 29 3b 0a 09 7d , resultObj);..}
16d0: 20 65 6c 73 65 20 7b 0a 09 20 20 20 20 54 63 6c else {.. Tcl
16e0: 44 65 63 72 52 65 66 43 6f 75 6e 74 28 72 65 73 DecrRefCount(res
16f0: 75 6c 74 4f 62 6a 29 3b 0a 09 7d 0a 09 72 65 74 ultObj);..}..ret
1700: 75 72 6e 20 72 65 73 75 6c 74 3b 0a 0a 20 20 20 urn result;..
1710: 20 61 62 6e 6f 72 6d 61 6c 52 65 73 75 6c 74 3a abnormalResult:
1720: 0a 09 54 63 6c 5f 44 69 63 74 4f 62 6a 44 6f 6e ..Tcl_DictObjDon
1730: 65 28 26 73 65 61 72 63 68 29 3b 0a 09 54 63 6c e(&search);..Tcl
1740: 44 65 63 72 52 65 66 43 6f 75 6e 74 28 6b 65 79 DecrRefCount(key
1750: 4f 62 6a 29 3b 0a 09 54 63 6c 44 65 63 72 52 65 Obj);..TclDecrRe
1760: 66 43 6f 75 6e 74 28 76 61 6c 75 65 4f 62 6a 29 fCount(valueObj)
1770: 3b 0a 09 54 63 6c 44 65 63 72 52 65 66 43 6f 75 ;..TclDecrRefCou
1780: 6e 74 28 6b 65 79 56 61 72 4f 62 6a 29 3b 0a 09 nt(keyVarObj);..
1790: 54 63 6c 44 65 63 72 52 65 66 43 6f 75 6e 74 28 TclDecrRefCount(
17a0: 76 61 6c 75 65 56 61 72 4f 62 6a 29 3b 0a 09 54 valueVarObj);..T
17b0: 63 6c 44 65 63 72 52 65 66 43 6f 75 6e 74 28 73 clDecrRefCount(s
17c0: 63 72 69 70 74 4f 62 6a 29 3b 0a 09 54 63 6c 44 criptObj);..TclD
17d0: 65 63 72 52 65 66 43 6f 75 6e 74 28 72 65 73 75 ecrRefCount(resu
17e0: 6c 74 4f 62 6a 29 3b 0a 09 72 65 74 75 72 6e 20 ltObj);..return
17f0: 72 65 73 75 6c 74 3b 0a 20 20 20 20 7d 0a 20 20 result;. }.
1800: 20 20 54 63 6c 5f 50 61 6e 69 63 28 22 75 6e 65 Tcl_Panic("une
1810: 78 70 65 63 74 65 64 20 66 61 6c 6c 74 68 72 6f xpected fallthro
1820: 75 67 68 22 29 3b 0a 20 20 20 20 2f 2a 20 43 6f ugh");. /* Co
1830: 6e 74 72 6f 6c 20 6e 65 76 65 72 20 72 65 61 63 ntrol never reac
1840: 68 65 73 20 74 68 69 73 20 70 6f 69 6e 74 2e 20 hes this point.
1850: 2a 2f 0a 20 20 20 20 72 65 74 75 72 6e 20 54 43 */. return TC
1860: 4c 5f 45 52 52 4f 52 3b 0a 7d 0a 0c 0a 0a 0a L_ERROR;.}.....
