Source Files

• portions of tclUtil.c

Public Interface

• None

Private Interface

• TclGetIntForIndex
• TclGetIntForIndexM

Directly Depends On Public Interface

• Tcl_Obj System
• Conversions From String
• string Object Type

Directly Depends On Private Interface of

• Parsing and Evaluation
• Numbers

Discussion

This is the parser for Tcl values that indicate a position in a Tcl list or string. Recognizes the format (end|integer)((+/-)integer)?

It operates on numbers in the int range. When Tcl lists and string are allowed to have length greater than INT_MAX, these routines will require an interface change.

The parser as written favors code re-use and clarity over absolute performance seeking.

It's difficult to imagine that the *M macro form is actually worth the trouble. As is, it only operates at all on 32-bit systems.