article Related Topics:
Tcl-Tk :: TCL :: TclRobots
 

__TOC__

Tcl (originally from "Tool Command Language", but nonetheless conventionally rendered as "Tcl" rather than "TCL"; and pronounced like "tickle") is a scripting language created by John Ousterhout. Originally "born out of frustration" — according to the author — with programmers devising their own (poor quality) languages intended to be embedded into applications, Tcl quickly gained wide acceptance on its own and is generally thought to be easy to learn, but powerful in competent hands. It is most commonly used for rapid prototyping, scripted applications, GUIs and testing. Tcl is also used for CGI scripting.

The combination of Tcl and the Tk GUI toolkit is referred to as Tcl/Tk.

Features


Tcl's features include:

  • Everything is a command, including language structures. They are in Polish notation.
  • Everything can be dynamically redefined and overridden.
  • All data types can be manipulated as strings, including code.
  • Extremely simple syntactic rules.
  • Event-driven interface to sockets and files. Time based and user defined events are also possible.
  • Flexible scope, with variable visibility restricted to lexical (static) scope by default, but uplevel and upvar allowing procs to interact with the enclosing functions' scopes.
  • Simple exception handling using exception code returned by all command executions.
  • Readily extensible, via C, C++, Java, and Tcl.
  • Interpreted language, code can be created and modified dynamically, but still fast due to compiling into bytecode.
  • Full Unicode (3.1) support, first released 1999.
  • Platform independent: Win32, UNIX, Linux, Mac, etc.
  • Close integration with windowing (GUI) interface Tk.
  • Easy to maintain code. Tcl scripts are often more compact and readable than functionally equivalent code in other languages.
  • Can be used for many purposes, and in many environments: as a text-only scripted language, as a GUI-capable language for applications, as an embedded language in: web pages (server-side; or client-side, as Tclets), and databases (server-side, in PostgreSQL).
  • Exists as development version (e. g. ActiveState Tcl), as tclkit (kind of runtime version, only about 1 megabyte in size, as starpack (single-file executable of a script/program), as BSD licensed freely distributable source

Tcl did not originally support object oriented syntax, being a functional language, but recent versions do support extensions which provide OO functionality, such as the XOTcl extension to Tcl. Other OO extensions also exist, such as incr Tcl, Snit, and STOOOP (simple tcl-only object-oriented programming).

Functional programming can easily be done in Tcl, as higher-order functions or functional abstractions are built into the language, though it is not widely used for this purpose. As an example, consider the ease with which two functions can be composed: proc o {f g x} {$f $x}

Syntax


Very simple and consistent syntax

Tcl has a very simple syntax which is applied in a consistent way. A Tcl script consists of several commands. A command is a list of words separated by whitespace.

word0 word1 word2 ... wordN

The first word is the name of a command, which is not built into the language, but which is in the library. The following words are arguments. So we have:

commandName argument1 argument2 ... argumentN

Any argument may be replaced by another command in square brackets. The subcommand is evaluated first and the result is substituted as the argument. Alternatively, any argument placed in curly braces will not be evaluated, but rather will be handed directly back to the original command as an argument.

To summarize: there is one basic construct (the command) and a set of simple substitution rules, and only the square brackets, the curly braces, quotes, and the backslash have special meaning. The single equality sign (=) for example is not used at all, and the double equality sign (==) is the test for equality, and even then only in the expr command.

All commands have the same structure: a keyword which is followed by several parameters. A command is terminated by a newline or a semicolon. Even comments are just commands which happen to do nothing.

Tcl is not statically typed: each variable may contain integers, floats, strings, lists or any other value.

Symbols with a special meaning
$ variable substitution (e.g. $argv0 might be replaced by /usr/bin/tclsh)
* subcommand substitution (e.g. * might be replaced by /home/joe)
"" word grouping with substitutions (e.g. "you are $user" is one word; substitution still occurs)
{} word grouping without substitutions (e.g. {you are $user} is one word, where $user is not replaced)
\ backslash substitution/escape (see Tcl documentation for full list) or statement continuation (by default, statement ends with the line)
# comment (only at the beginning of a statement)
; statement separator
:: namespace path separator for variables or commands (e.g. ::foo::bar)

Some examples of commands

Assignments are made with the command set, no equality sign.

set variable value

While loops are implemented by the command while which takes two arguments. The first argument is a Tcl expression (expressions are written in what is essentially a miniature language for doing C-style math and comparison expressions). The second argument is the script to run on every iteration. They are generally put in curly braces to avoid immediate execution.

while { * } { aTclCommand anotherTclCommand .... }

If command

if {$x < 0} { set x 0 }

Commands may have no arguments

pwd

gives back the current working directory. With

set wdir *

you store the string describing the working directory in the variable wdir.

A command may give back as a result a list

glob aPattern

gives back a list of file names in the working directory whose names match aPattern.

Procedures

Procedures are defined as follows

proc nameOfProc { argumentList } { .... .... }

Associative arrays

The following code snippet creates and initializes an associative array which in other languages is called a map, dictionary, or hash table.

set capital(France) Paris set capital(Italy) Rome set capital(Germany) Berlin set capital(Poland) Warsaw set capital(Russia) Moscow set capital(Spain) Madrid

To query it and put the result on standard output use

puts $capital(Italy)

To get a list of all countries for which a capital is defined use array names capital

The result is unsorted because Tcl arrays are based on hash tables.

Poland Spain Russia Germany Italy France

If you like to have it sorted use

lsort names capital

Note however that arrays are collections of variables, not first-class objects, and cannot be freely passed around the way strings are. The commands

set CapitalCopy $capital

and

DoSomethingWith $capital

both produce the error message

can't read "capital": variable is array

In general, note that Tcl has a different concept of references than some people might expect. To refer to an array (to pass it by reference), give its variable name: proc demo _arr { upvar 1 $_arr arr ;# tie the reference to a local name #do something with arr }

To pass the contents of an array by value, use array get resp. array set. For example, to copy one array to another:

array set Newarr get Oldarr

For pure-value associative arrays, Tcl introduced the dict type in version 8.5.

Extension packages


The Tcl language has always supported extension packages, which provide additional functionality (such as a GUI, terminal-based application automation, database access, etc.)

The most popular Tcl extension is the Tk toolkit, which provides a graphical user interface library for a variety of operating systems. Each GUI consists of one or more frames. Each frame has a layout manager.

Another popular extension is Expect, which allows automated driving of terminal-based programs (such as passwd, ftp, telnet and command driven shells).

A number of database extensions are available:

Examples


Hello, world!

puts "Hello, world!"

or

puts {Hello, world!}

Echo server

A simple working example, demonstrating event-based handling of a socket, follows.


  1. !/usr/bin/env tclsh

  1. echo server that can handle multiple
  2. simultaneous connections.

proc newConnection { sock addr port } { # client connections will be handled in # line-buffered, non-blocking mode fconfigure $sock -blocking no -buffering line

# call handleData when socket is readable fileevent $sock readable list handleData $sock }

proc handleData { sock } { puts $sock gets $sock if { eof $sock } { close $sock } }

  1. handle all connections to port given
  2. as argument when server was invoked
  3. by calling newConnection
set port lindex $argv 0 socket -server newConnection $port

  1. enter the event loop by waiting
  2. on a dummy variable that is otherwise
  3. unused.
vwait forever

Digital clock

Another example using Tk (from A simple A/D clock) and timer events, a digital clock in three lines of code:

proc every {ms body} { eval $body after $ms every $ms $body } pack .clock -textvar time every 1000 {set ::time format *} ;# RS

Explanation: the first line defines a command, "every", which re-schedules an action ('body') every 'ms' milliseconds; the second creates a label whose content is bound to the variable 'time'; the third line arranges so that the variable 'time' is updated to formatted local time every second.

Note that the "every" command treats its first parameter as a number and its second parameter as a script, resulting in correct calls being those programs that pass in arguments that look like those pieces of syntax. However, the Tcl interpreter assigns no special syntactic interpretation to either argument, meaning that the code is free to interpret those arguments as desired. (By contrast, a language using a conventional BNF description could only achieve the equivalent functionality by defining "every" as a keyword, adding extra syntax to mark the executable argument, or by making the curly braces deeply magical indeed, possibly requiring a more complex declaration.)

List of content of associative array

In array tcl_platform, platform-specific properties are kept. A list of the names of the properties is obtained by

array names tcl_platform

The following snippet lists them together with their values

foreach i names tcl_platform { puts concat $i= $tcl_platform($i) }

If the properties should be sorted

foreach i * { puts concat $i= $tcl_platform($i) }

This demonstrates how commands may be nested. In fact they may be nested to any depth. If you want it fancier (keys padded with blanks so that the equal signs align) just use the proc parray that comes delivered with Tcl.

Intersection of two sets

The filter procedure returns those elements of the list where the script returns TRUE:

proc filter {list script} { set res {} foreach e $list {if {1 $script $e} {lappend res $e}} return $res }

The in procedure is shorthand for list inclusion:

proc in {list e} {expr {-exact $list $e>=0}}

Testing: % filter {a b c} {in {b c d}} b c

Factorial

proc ! x {expr {$x<2? 1: $x**}}

This demonstrates that any string can be a command name, and the ?: operator as from C is available in Tcl expressions too. Also, recursion is easily possible, although Tcl has no tail call optimisation so the maximum depth of recursion is restricted.

History


The Tcl programming language was created in the spring of 1988 by John Ousterhout while working at the University of California at Berkeley.

Timeline
Date Event
January 1990 Tcl announced beyond Berkeley (Winter USENIX).
June 1990 Expect announced (Summer USENIX).
January 1991 First announcement of Tk (Winter USENIX).
June 1993 First Tcl/Tk conference (Berkeley). geometry manager (forerunner of [grid), Tcl, TclDP and Groupkit, announced there.

(Need rest of potted history!)

References

  • John K. Ousterhout, Tcl and the Tk Toolkit, Addison-Wesley, Reading, MA, USA, ISBN 0-201-63337-X, 1994.
  • Brent B. Welch, Practical Programming in Tcl and Tk, Prentice Hall, Upper Saddle River, NJ, USA, ISBN 0-13-038560-3, 2003.
  • J Adrian Zimmer, Tcl/Tk for Programmers, IEEE Computer Society, distributed by John Wiley and Sons, ISBN 0-8186-8515-8, 1998. (Several chapters available online.)

See also


External links


Programming languages | Scripting languages | Dynamic programming languages

Tcl | Tcl | TCL | Tcl | Tool Command Language | TCL | Tcl/Tk | Tcl | TCL (programmeertaal) | Tcl/Tk | Tcl | Tcl | Tcl | Tcl | TCL | Tcl | Tcl | Tcl | Tcl (мова програмування) | Tcl

 

This article is licensed under the GNU Free Documentation License. It uses material from the "Tcl".

Home Pageartsbusinesscomputersgameshealthhospitalshomekids & teensnewsphysiciansrecreationreferenceregionalscienceshoppingsocietysportsworld