Updated 2013-04-29 18:39:54 by pooryorick

Summary  edit

One very interesting feature of Tcl is that you can write your own control structures, essentially extending the language.

See Also  edit

try ... finally ...
do...until in Tcl
for ... in ...
Algebraic Types
pattern matching capabilities a-la Haskell or OCaml
recursion in a single stack frame
Countdown program
asynchronous foreach

Description  edit

RWT (with a lot of help from comp.lang.tcl) 2000-02-04:

The [uplevel] command, which allows you to write a [proc]edure which executes code in the context of the caller, is the trick.

For example, if we want to augment Tcl's standard [for] and [while] looping constructs with
do body while condition

we would simply write a do proc which executes the code in the caller's context. In its simplest form, it would look like this:
proc do {body condition} {
    while {1} {
        uplevel $body
        if {![uplevel "expr $condition"]} {break}

We can make this a little more robust by specifying the exact number of levels to [uplevel], which may prevent $body from being misinterpreted. We should also use [list] to construct the conditional command.
proc do {body condition} {
    while {1} {
        uplevel 1 $body
        if {![uplevel 1 [list expr $condition]]} {break}

Just to make things look prettier, we can add an exra argument to [do] that expects the word while. You could probably get fancy and make the while optional (like the else is optional for the if command), but this should be good enough for our purposes.
proc do {body whileword condition} {
    if {![string equal $whileword while]} {
        error "should be \"do body while condition\""
    while {1} {
        uplevel 1 $body
        if {![uplevel 1 [list expr $condition]]} {break}

This procedure does not handle errors well, though. For a good discussion of the issues involved, take a look at the exception handling chapter in John Ousterhout's book BOOK Tcl and the Tk Toolkit. But the primary issue is that we want to catch exceptional conditions when executing the $body code, and correctly throw errors upwards. This error handling makes our new procedure really appear to be part of the language.

Recall that the error codes are

  • 0 OK
  • 1 error (should be thrown upwards)
  • 2 return (throw that upwards, too)
  • 3 break (stop execution of our loop)
  • 4 continue (just continue)
  • anything else is a user defined code.
proc do {body whileword condition} {
    global errorInfor errorCode
    if {![string equal $whileword while]} {
        error "should be \"do body while condition\""
    while {1} {
        set code [catch {uplevel 1 $body} message]
        switch -- $code {
          0 { }
          1 { return  -code      error \
                      -errorinfo $::errorInfo \
                      -errorcode $::errorCode $message }
          2 { return -code return $message }
          3 { return {} }
          4 { }
          default { return -code $code $message }
        if {![uplevel 1 [list expr $condition]]} {break}

To make this really really really robust, you should consider adding the same error handling to the uplevel condition, but that is left as an exercise for the reader.

Conditional Repeat  edit

GPS 2003-10-08:

Oct 08, 2003 - This is a conditional repeat:
proc repeat {cond time body} {
    if !$cond return
    uplevel #0 $body
    after $time [info level 0]
} ;#GPS
repeat {[winfo exists .foo]} 1000 {puts [.foo get]} 

Another version of that which is easier to parse mentally is:
proc repeat {body _every_ time _until_ cond} {
    if $cond return
    uplevel #0 $body
    after $time [info level 0]
} ;#GPS
repeat [list raise .rename .] every 1000 until {![winfo exists .rename]}

if ... in ...  edit

GPS 2003-10-19: I was going through a Python tutorial and came upon this nice concise code:
if ok in ('y', 'ye', 'yes'): return 1

I became curious about doing such a thing in Tcl, and I came up with this:
proc if.in.list {val list body} {
    if {[lsearch $list $val] >= 0} {uplevel $body}

Example usage:
% set v abc
% if.in.list $v [list abc adef foo] {puts TRUE}

slebetman: I personally use plain if for this with the following two procs:
proc either {val args} {
    if {[lsearch -exact $args $val] == -1} {return 0}
    return 1

proc neither {val args} {
    if {[lsearch -exact $args $val] == -1} {return 1}
    return 0

not really a control structure per se, just a sugar for if:
if [either $answer "y" "ye" "yes"] {puts TRUE}
if [neither $ext ".z" ".zip" ".gz" ".bz"] {error "Unsupported file type!"}

I find this cleaner to read than regular lsearch. It's safe to not brace the above if since either and neither will never return something which requires substitution. Unless of course someone redefines them.

Larry Smith: I would suggest "either" be "anyof" and "neither" be "noneof". "Either" and "Neither" are really only binary and use in a list expression is confusing.

RS: From Tcl 8.5, we can use expr's "in" operator to code like this:
if {$v in {abc adef foo}} {puts TRUE}

For Every Character  edit

Googie: Here is a structure which I met in EPIC4 (IRC client) scripting language.
#"For Every Character"
proc fec {var string body} {
    uplevel "
        for {set fec 0} {\[string index {$string} \$fec] != {}} {incr fec} {
            set $var \[string index {$string} \$fec]

It uses [uplevel] to allow using other variables in body. Using example:
set validFlags "abcde"
set flagsToSet "asdfghj"
fec flag $flagsToSet {
    if {[string first $flag $validFlags] == -1} {
        puts "Invalid flag: $flag"

RS: Note however that the following is probably faster (and avoids quoting hell ;^):
foreach flag [split $flagsToSet ""] {...}

Discussion  edit

NEM 2006-12-15: Writing new control structures is both difficult to get right, and also extremely useful when designing a program. Writing specialised, application-specific control structures can greatly improve the clarity of code and separation of concerns. For instance, if we are writing an NNTP newsreader application, a typical task would be to iterate over the new articles in some newsgroup and then perform some application-specific task on each one (e.g. displaying them, or storing them in a database). We could write this out directly using the facilities of the nntp package, explicitly looping over the articles and extracting each one. However, the problem with this is that we mix up the application code (displaying the articles) with the nntp code (retrieving the articles, iterating over them, fetching headers, dealing with network errors, etc). A clean way to separate this is to design a high-level specialised control structure for iterating over new articles in a newsgroup. Ideally, this would allow us to write our application code like the following:
foreachNewMsg {head body} [nntp::nntp $server $port] comp.lang.tcl {
    puts [join $head \n]
    puts "--------------------------------"
    puts [join $body \n]
    puts "================================"

This new foreachNewMsg control structure deals with selecting the group, iterating over new messages, fetching the headers and body, and closing the connection when we are finished. It handles all network-related errors, and ensures that the connection is always closed. This means that our application code doesn't have to deal with any network-related errors, as they are handled for us. All we have to worry about is any errors in our application-specific code. Implementing this new control structure is moderately difficult, but the pattern is very similar for most such specific control constructs (e.g., something very similar is in the do procedure further up this page). In this version, we even handle things like break/continue in the loop:
proc foreachNewMsg {vars con group script} {
    upvar 1 [lindex $vars 0] head [lindex $vars 1] body
    lassign [$con group $group] num first last group
    # Limit to 20 messages max
    if {$last - $first > 20} { set first [expr {$last - 20}] }
    for {set i $first} {$i <= $last} {incr i} {
        if {![catch {$con head $i} head] &&
            ![catch {$con body $i} body]} {
            switch -exact [catch { uplevel 1 $script } msg opts] {
                0       { }
                3       { break }
                4       { continue }
                default {
                    $con quit
                    return -options $opts $msg
    $con quit

Once you learn how to write this kind of custom control structure, it can really help to clean up your own code. See e.g. a higher-level channel API for a more complex example.

MJ: In the same vein as the example above, a structure that opens a file, executes a block on it and makes sure the file gets closed:
proc with-file {name var block} { 
    # name is the filename to open
    # var will contain the file_handle and can be used in the block
    # block will be executed in the current scope.
    upvar $var file 
    set file [open $name] 
    set code [catch {uplevel 1 $block} res]
    close $file 
    return -code $code  $res 

iu2: Tcl and Lisp are similiar in this aspect, they both enable the core language's syntax extension. Here is a beautiful paragraph describing the Lisp way of programming, which, I think, applies also to tcl (taken from http://www.paulgraham.com/progbot.html, which has many other good essays, recommended):

"Experienced Lisp programmers divide up their programs differently. As well as top-down design, they follow a principle which could be called bottom-up design-- changing the language to suit the problem. In Lisp, you don't just write your program down toward the language, you also build the language up toward your program. As you're writing a program you may think "I wish Lisp had such-and-such an operator." So you go and write it. Afterward you realize that using the new operator would simplify the design of another part of the program, and so on. Language and program evolve together. Like the border between two warring states, the boundary between language and program is drawn and redrawn, until eventually it comes to rest along the mountains and rivers, the natural frontiers of your problem. In the end your program will look as if the language had been designed for it. And when language and program fit one another well, you end up with code which is clear, small, and efficient."

slebetman: It should be noted that while Lispers consider this sort of thing as changing the syntax, seasoned Tclers don't. The Tcl way sees these things as just another command. Indeed, Tcl's syntax doesn't do much: you can't define a function, you can't perform loops, you can't test conditions, you can't even assign a value to a variable using Tcl syntax! Tcl does all those things using commands (which may or may not be implementable using the proc command). In Tcl, when we talk about changing the syntax we usually mean something which modifies or adds to the endekalogue/dodekalogue.

rahulj: Is it simple that to design pause for loop. one loop is continueing exectution and then user press some button(binded) and then resumes again on pressing someanother button. I am trying but no success.

NEM 2008-08-04: It's not impossible, but slightly tricky. In general, Tcl has no facility to interrupt an arbitrary computation and then restart it later on. However, if you structure the loop carefully, using the event loop then you can achieve something like this. What is the real problem you want to solve?