TIP 501: string is dict

Author:         Sean Woods <[email protected]>
State:          Final
Type:           Project
Vote:           Done
Created:        12-Feb-2018
Keywords:       Tcl,string
Tcl-Version:    8.7
Tcl-Branch:     tip-501
Vote-Summary:   Accepted 5/0/1
Votes-For:      DKF, KBK, JN, FV, SL
Votes-Against:  none
Votes-Present:  BG


This TIP proposes the addition of an is dict test to the string ensemble. The command will return true if the value is a valid dict, and false otherwise.


Currently the means to test of a string is a leaf node is to check if the string is a list and it's length is divisible by 2. The problem is that this requires 2 different calls from the interpreter, and generates a dict to list conversion for the most common case (namely that the value is, indeed, a dict.)

This TIP proposes a shortcut in C to check to see if the internal representation is already a dict, and provide a shortcut for the most common case.


A new branch has been added to the tcl fossil system tip-501

The crux of the implementation is adding "dict" to the IS ensemble:

 * We ignore the strictness here, since empty strings are always
 * well-formed lists.
int dresult, dsize;
dresult = Tcl_DictObjSize(NULL, objPtr, &dsize);
result = (dresult==TCL_OK) ? 1 : 0;