TCL培训教程：综合指南

深圳市华为技术有限公司文档编号产品版本密级研究管理部文档中心产品名称：测试平台共76页 TCL培训教程(全) (仅供内部使用) 拟制：审核：审核：批准：陈旭盛日期：日期：日期：日期：深圳市华为技术有限公司版权所有侵权必究 2000/12/08 yyyy/mm/dd yyyy/mm/dd yyyy/mm/dd TCL培训教程程(全) 2010-11-02 绝密请输入文档档编号版权所所有，侵权必究究第2页，共共76页 TCL培训教程(全) 程绝密请输入文档档编号修订记录日期修订订版本 2000/12/08 2.00 2010-11--02 描述初稿完成作者陈旭盛盛版权所所有，侵权必究究第3页，共共76页 TCL培训教程程(全) 2010-11-02 绝密请输入文档档编号版权所所有，侵权必究究第4页，共76页 TCL培训教程程(全) 2010-11-02 绝密请输入文档档编号版权所所有，侵权必究究第5页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号目录 1引言言 2语法法 2.11脚本、命令令和单词符号号 2.22置换(substittution) 2.2.1变量置置换(variable subtitution) 2.2.2命令置置换(commannd substitutionn) 2.2.3反斜杠杠置换(backsslash substitution) 2.2.4双引号号和花括号 2.33注释 3变量量 3.11简单变量 3.22数组 3.33相关命令 3.3.1set 3.3.2unset 3.3.3append d和incr 4表达达式 4.11操作数 4.22运算符和优优先级 4.33数学函数 5List 5.11list命令 5.22concat命令: 5.33lindex命令 5.44llength命令 5.55linsert命令 5.66lreplace命令令: 5.77lrange 命令: 5.88lappend命令令: 5.99lsearch 命令令: 5.110lsort命令: 5.111split命令: 5.112join命令 6控制制流 6.11if命令 6.22循环命令：while 、for、 foreach 6.2.1while命令命 6.2.2for命令令 2010-11--02 版权所所有，侵权必究究 6 7 7 7 8 8 8 9 9 10 10 11 11 11 11 12 12 12 12 13 14 14 14 15 15 15 15 15 15 16 16 16 17 17 17 17 17 18 第6页，共76页 TCL培训教程程(全) 绝密请输入文档档编号 6.2.3foreach h命令 6.2.4break和continue命令令 6.2.5switch 命令 6.11eval命令 6.22source命令 7过程程(procedure) 7.11过程定义和和返回值 7.22局部变量和和全局变量 7.33缺省参数和和可变个数参参数 7.44引用：upvaar 8字符符串操作 8.11format命令 8.22scan命令 8.33regexp命令 8.44regsub命令 8.55string命令 c ?-noccase? ?-lengthh int? string1 string2 s 8.5.1string compare 8.5.2string equal ?-nocasse? ?-length int? string1 sttring2 8.5.3string first string1 sttring2 ?startinndex? c 8.5.4string index string charIndex 8.5.5string last string1 string2 ?starrtindex? 8.5.6string length strinng m ?-nocasse? pattern striing 8.5.7string match 8.5.8string range stringg first last 8.5.9string repeat stringg count g replace string s first last l ?newstrinng? 8.5.10string 8.5.11string g tolower strring ?first? ?last? ? 8.5.12string g toupper striing ?first? ?last? 8.5.13 string g trim strinng ?chars? 8.5.14string g trimleft strinng ?chars? 8.5.15string g trimright string s ?charss? 9文件件访问 9.11文件名 9.22基本文件输输入输出命令令 9.33随机文件访访问 9.44 当前工作目目录 9.55文件操作和和获取文件信信息 10错误误和异常 100.1错误 100.2从TCL脚本本中产生错误误 100.3使用catch捕获错误捕 100.4其他异常 2010-11--02 版权所所有，侵权必究究 18 19 19 19 19 20 20 20 21 21 22 22 23 23 25 25 25 25 26 26 26 26 26 27 27 27 27 27 27 27 27 28 28 28 29 30 30 33 33 34 35 35 第7页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 11深入入TCL 11.1查询数组中的元素 11.2 info命令 11.2.1变量量信息 11.2.2过程程信息 11.2.3命令令信息 11.2.4 TCL L的版本和库库 11.2.5 命令令的执行时间间 11.2.6 跟踪踪变量 11.2.7 命令令的重命名和和删除 11.2.8 unkn nown命令 11.2.9自动动加载史记录 12历史 13TCL L和C\C++ 13.1生成自己的TCLSH 13.2扩展自己的命令：方方法(一) 13.2.1编写扩展命令对对应的C/C++过程过 13.2.2注册册命令 13.2.3命令令返回值和命命令对应的过过程的返回值值 13.3扩展自己的命令：方方法(二) 13.3.1Tcl_O Obj结构 13.3.2编写扩展命令对对应的C/C++过程过 13.3.3注册册命令 13.4利用clientD Data参数和deleteProc d 参数数应嵌入TCL 13.5在C/C++应用程序中嵌结 14总结 2010-11--02 版权所所有，侵权必究究 37 37 38 38 39 40 41 41 41 43 44 44 45 47 48 48 48 49 50 52 52 54 54 55 58 59 第8页，共共76页 TCL培训教程程(全) 2010-11-02 绝密请输入文档档编号版权所所有，侵权必究究第9页，共76页 TCL培训教程(全) 程绝密请输入文档档编号 TCL培训教程(全) 关键词：TCL 要：本文是TCL L教材的第三三稿，前两稿稿分别是《《TCL的使用》和《TCL培训教程》培。这摘一稿加入了了不少内容，是北研TCL L兴趣小组共共同努力的结果。本文文详细介绍了了TCL 的各个方面面，特别对利利用C\C++语言扩展语 TCL L命令作了详详细论述。本本文附有大大量实例。缩略语清单： TCL 一种脚本语语言 Tool Coommand Lannguage 参考资料清单：请在表在表格中罗列本本文档所引用用的有关参考文文献名称、作作者、标题、编编号、发布日日期和出版单位等基基本信息。参考考资料清单名称作者编号发布布日期查阅阅地点或出版版单位（若不不渠渠道为本为本公司发布的的文献，请填写此文献此列） Tcl and a Tk ToolK Kit Jo ohn 981－2355－ K.Ousterhout K t 951－6 1999 TCL的使用陈旭盛陈 TCL培培训教程陈旭盛陈自己己的图书 Addison Weesley Pubblishing Com mmpany 自写写文档自写写文档 1 引言 TCL((Tool Commaand Language))是一种解释执执行的脚本语语言(Scripting Language)。它提供了通用的通编程能力力：支持变量量、过程和控控制结构；同时TCL还拥拥有一个功能能强大的固有的核心命令集集。由于TCL的解释器器是用一个C\C C++语言的过过程库实现的，，因此在某种种意义上我们又可以把TCL L看作有丰富的用于扩扩展TCL命令令的C\C++过程程和函数，可可以很容易就在C\C++应用用程序一个C库，这个库中有 CL，而且每个个应用程序都都可以根据自己的需要对T TCL语言进行行扩展。我们可可以针对某一一特定中嵌入TC 应用领域对TCL语言的的核心命令集集进行扩展，加加入适合于自自己的应用领领域的扩展命令令，如果需要要，甚结构，TCL解解释器将把扩展展命令和扩展展控制结构与与固有命令和固固有控制结构构同等至可以加入新的控制结扩展后的TCL语语言将可以继继承TCL 核心心部分的所有有功能，包括核核心命令、控控制结构、数数据类看待。扩 2010-11--02 版权所所有，侵权必究究第10页，共76页 TCL培训教程程(全) 绝密请输入文档档编号型、对过程的支持等。。根据需要，我们甚至可以屏蔽掉TCL L的某些固有有命令和固有控控制结构。通通过对展、继承或屏屏蔽，用户用用不着象平时定定义一种计算算机语言那样样对词法、语法法、语义、语语用等 TCL的扩展各方面加以定义，就可可以方便的为为自己的应用领领域提供一种种功能完备的脚脚本语言。展性使得它能能很好地适应产产品测试的需需要，测试任任务常常会由于于设计和需求求的改 TCL良好的可扩展让测试人员疲疲于应付。利用用TCL的可扩扩展性，测试试人员就可以迅迅速继承多种种新技变而迅速改变，往往让点迅速推出扩扩展TCL命令集集，以用于产产品的测试中，可以较容易易跟上设计需需求的术，并针对产品新特点变化。是一种比C\C+ ++ 语言有着更更高抽象层次次的语言，使使用TCL可以在在一种更高的的层次另外，因为TCL是掉了编写C\C+ ++程序时必须须涉及到的一一些较为烦琐的细节，可以以大大地提高高开发上编写程序，它屏蔽掉语言写的测试试例脚本，即使使作了修改，也用不着重新新编译就可以以调用测试例的速度。而且，使用TCL语器直接执行。可以省却不少时间。 TCL解释器 TCL 目前已成为自自动测试中事事实上的标准。。 2 语法简单的讲，TCL语语言的语法实际上是一些T TCL解释器怎样对TCL命令令进行分析的规则的集合。 2.1 脚本、命命令和单词符符号一个TCL脚本可以以包含一个或或多个命令。命命令之间必须须用换行符或或分号隔开，下下面的两个脚脚本都是合法的： set a 1 set b 2 或 set a 1；set b 2 令包含一个或或几个单词，第第一个单词代代表命令名，另外的单词则则是这个命令令的参 TCL的每一个命令空格或TAB键键隔开。数，单词之间必须用空解释器对一个个命令的求值值过程分为两部部分：分析和和执行。在分析析阶段，TCL L 解释器运用用规则 TCL解把命令分成一个个独立立的单词，同同时进行必要的置换(substiitution)；在执执行阶段，T TCL 解释器会会把第个命令是否有定义，如果有有定义就激活活这个命令对应的C/C++过过程，一个单词当作命令名，并查看这个参数传递给该该命令过程，让让命令过程进进行处理。并把所有的单词作为参 2.2 置换(substitution)) 2010-11--02 版权所所有，侵权必究究第11页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号注：在下面的所有有章节的例子子中，'％'为TC CL的命令提示示符，输入命命令回车后，T TCL会在接着着的一说明，不是例例子的一部分。。行输出命令执行结果。'//'后面是我自己加上的说解释器在分析析命令时，把所有的命令参参数都当作字字符串看待，例例如： TCL解 %set x 10 ///定义变量x,并并把x的值赋为为10 10 y的值是x+100，而不是我我们期望的1100 %set y x+100 //y x+1000 上例的第二个命令令中，x被看作字符串x+1100的一部分，如果我们想想使用x的值''10' ，就必须须告诉器：我们在这这里期望的是是变量x的值，而非字符'x'。。怎么告诉TCL解释器呢，这就要用到到TCL TCL解释器语言中提供的置换功能能。提供三种形式式的置换：变变量置换、命令令置换和反斜斜杠置换。每每种置换都会导导致一个或多多个单 TCL提词本身被其他的值所代代替。置换可可以发生在包括括命令名在内内的每一个单词词中，而且置置换可以嵌套。。 2.22.1 变量置换(variable subtitution) ＄符号标记，变量置换会导导致变量的值值插入一个单词词中。例如：变量置换由一个＄ / 100，这里x被被置换成它的的值10 %set y $x+100 //y的值是10+ 10＋100 不是我们想要的的值110，而是是10+100，因因为TCL解释释器把10+100看看成是一个字字符串这时，y的值还不令置换，使得得TCL会把10+ +100看成一个个表达式并求值值。而不是表达式，y要想得到值110，还必须用命令 2.22.2 命令置换(command sub bstitution) 括起来的TCL命命令及其参数数，命令置换换会导致某一个命令的所有有或部分单词词被另命令置换是由[]括替。例如：一个命令的结果所代替 %set y [expr $x+100] 110 值是110，这里里当TCL解释器遇到字符'[['时，它就会把把随后的exprr作为一个命令令名，从而激激活与 y的值 expr对应的的C/C++过程程，并把'expr'和和变量置换后后得到的'10+110'传递给该命命令过程进行行处理。如果在上例中我们们去掉[]，那么么TCL会报错错。因为在正常常情况下，TCL解释器只把把命令行中的的第一字符串处理，看作是命令的的参数。个单词作为看作命令，其他的单词都作为普通字意，[]中必须是是一个合法的的TCL脚本，长长度不限。[]]中脚本的值为最后一个命命令的返回值值，例注意如： +100;set b 3000] //y的值为3300，因为set b 300的返回回值为300 %set y [expr $x+ 2010-11--02 版权所所有，侵权必究究第12页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 300 有了命令置换，实实际上就表示示命令之间是可可以嵌套的，即一个命令令的结果可以作作为别的命令令的参数。 2.22.3 反斜杠置换(backslash substitution) 语言中的反斜斜杠置换类似似于C语言中反斜杠的用法法，主要用于于在单词符号号中插入诸如如换行 TCL语符、空格、[、$等被TCL解释器当作作特殊符号对对待的字符。例例如： m multiple\\ space //msg的值为multipple space。 set msg 如果没有'\'的话，TCL会报错，因为解释器器会把这里最后后两个单词之之间的空格认为为是分隔符，于是命令有多于两个个参数，从而而报错。加入了'\'后，空格格不被当作分隔隔符，'multipple space'被认认为是发现set命一个单词(word)。又例例如： %set msg money\ \$3333\ \nArrray\ a\[2] 个命令的执行行结果为：mooney $3333 //这个 Array a[2] 符。这里的$不再被当作变量置换符支持以下的反反斜杠置换: TCL支 Backkslash Sequencce Reeplaced By \aa Audible alertt (0x7) \bb Backspace (00x8) \ff Form feed (0xxc) \nn Newline (0xaa) \rr Carriage retuurn (0xd) \t Tab (0x9) \vv ( Vertical tab (0xb) \dddd Octal value given g by ddd (one, two, or three d's) \xxhh Hex value givven by hh (any number of h's) n spacee \ newline A single spacce character. 例如如：％seet a \x48 //对应 \xhhh H //十六进制制的48正好是是72，对应H 2010-11--02 版权所所有，侵权必究究第13页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号％ set s a \110 //对应 H 的110正好是是72，对应H //八进制的％sett a [expr \ // 对应\newline space，一个命令可可以用\newline转到下一行继续 \ddd 2+33] 5 2.22.4 双引号和花括号外，TCL提供供另外两种方法法来使得解释释器把分隔符符和置换符等特特殊字符当作作普通除了使用反斜杠外理，这就要使使用双引号和花花括号({})。字符，而不作特殊处理解释器对双引引号中的各种种分隔符将不不作处理，但是对换行符及＄和[]两种种置换符会照照常处 TCL解理。例如： %set x 100 100 %set y "$x ddd" 100 ddd 所有特殊字符符都将成为普通通字符，失去去其特殊意义义，TCL解释器器不会对其作作特殊而在花括号中，所处理。 xpr 10+100]} %set y {/n$x [ex /n$x [expr 10+100] 2..3 注释是'＃'，'＃'和直直到所在行结结尾的所有字符符都被TCL看看作注释，TC CL解释器对注注释将 TCL中的注释符是是，'＃'必须出出现在TCL解释释器期望命令令的第一个字符符出现的地方方，才不作任何处理。不过，要注意的是被当作注释。例如： This is a comm ment %＃T %set a 100 # Not N a commeent uld be "set varN rName ?newV Value?" wronng # args: shou %set b 101 ; # thiis is a commennt 101 第二行中'＃'就不被当作注释符符，因为它出出现在命令的中中间，TCL解解释器把它和后后面的字符当当作命令的参数处理，从而导导致错误。而而第四行的'＃''就被作为注释释，因为前一一个命令已经用用一个分号结结束，器期望下一个个命令接着出现。现在在这这个位置出现现'#'，随后的字字符就被当作注释了。 TCL解释器 2010-11--02 版权所所有，侵权必究究第14页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 3 变量 TCL支持两种类支类型的变量：简单变量和和数组。 3.1 简单变量量一个个TCL的简单单变量包含两两个部分：名字和值。名字和值都都可以是任意意字符串。例如一个名为 “1323 7& &*: hdgg" 的变量在 TC CL 中都是合法的。不过为了更好的使用置换 (substitution)，变量名名最好按C\C++语言中标标识符的命名名规则命名。。 TCL解释器器在分析一一个变量置换时时，只把从＄＄符号往后直直到第一个个不是字母、数字或下划划线的字符之之间的单词词符号作为要被被置换的变量量的名字。例例如: % set a 2 2 set a.1 4 4 % set b $a.1 2.1 行，我们希望望把变量a.1的的值付给b，但但是TCL解释器器在分析时只只把$符号之后后直到在最后一个命令行字或下划线的的字符(这里是是'.')之间的单词符号(这这里是'a')当作作要被置换的的变量第一个不是字母、数字成2,然后把字符符串“2.1”付给给变量b。这显显然与我们的的初衷不同。的名字，所以TCL解释器把a置换成当然然，如果变量量名中有不是是字母、数字或下划线线的字符，又又要用置换，，可以用花花括号把变量名名括起来。例例如： %set b ${a.1} 4 令能生成一个个变量、也能能读取或改变变一个变量的值。例如如： TCL中的set命令％ seet a {kdfj kjdff} kdfj kjdf k 如果果变量a还没有定义，这这个命令将生生成变量a，并将其值置置为kdfj kjddf，若a已定定义，就简单的的把a的值置置为kdfj kjdf。％sett a kdfj kjdf k 2010-11--02 版权所所有，侵权必究究第15页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号这个个只有一个参参数的set命令令读取a的当当前值kdfj kjdf。 3.2 数组数组组是一些元素的的集合。TCL的数组和普通通计算机语言言中的数组有很很大的区别。在TCL中，不不能单独声明一个数组，数组组只能和数组组元素一起声明。数组中，数组元素的的名字包含两部部分：数组名名和数组中元素的名字，TCL中数组元素的的名字（下标标〕可以为任何何字符串。例如：例 seet day(monday) 1 seet 2 day(tuesdaay) 第第一个命令生生成一个名为 day 的数组组，同时在数组中生成成一个名为 monday m 的数组元素，并把把值置为1，第二个命令令生成一个名名为tuesday的数组元素，的，并把值置为2。简单单变量的置换已经在前前一节讨论过过，这里讲讲一下数组元元素的置换。。除了有括括号之外，数组组元素的置换换和简单变量量类似。例例： seet a monday seet day(mond day) 1 seet b $day(mo onday) //b的值值为1，即daay(monday)的值。的 seet c $day($a)) //c的值为为1，即day((monday)的值值。 TCL不不能支持复杂杂的数据类型,这是一个很大大的缺憾，也也是TCL受指责责很多的方面面。但是TCL的的一个扩展ITCL填补了这个缺缺憾。 3.3 相关命令令 3.33.1 set 这这个命令在3. 1已有详细介绍。 3.33.2 unset 这个个命令从解释释器中删除变量量，它后面可可以有任意多个参数，每个个参数是一个个变量名,可以以是简单变量，也可以是数组组或数组元素素。例如： y(monday) % unset a b day 除了变量a、bb和数组元素dday(monday)，但是数组dday并没有删除除，其他元素素还存上面的语句中删除数组的名字。例例如：在，要删除整个数组，只需给出数 day) %puts $day(mond y(monday)": no such eleement in arrray can't read "day % puts $day(tuesday) 2010-11--02 版权所所有，侵权必究究第16页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 2 %unset day % puts $day(tuesday) y(tuesday)": no such vaariable can't read "day 3.33.3 append和和incr 这两个命令提供了了改变变量的的值的简单手段段。本加到一个变变量的后面，例例如： append命令把文本 % set txt hello hello % append txt "! How are yoou" hello! How are you 变量值加上一一个整数。inccr要求变量原原来的值和新加加的值都必须须是整数。 incr命令把一个变 %set b a a % incr b " expected integer but got "a" %set b 2 2 %incr b 3 5 4 表达式 TCL中中的表达式类似于ANSI C的的表达式。表表达式由操作数数和操作符构构成，下面分别别介绍。 4..1 操作数表达式的操作作数通常是整数或实数。整整数一般是十十进制的， TCL表但如果整数数的第一个字字符是 0(zero)，那么TCL将把把这个整数看看作八进制的的，如果前两个字符是0x则则这个整数被被看作是十六六进制的实数的写法与ANSI C中完完全一样。如如：的。TCL的 2..1 7..9e+12 6ee4 2010-11--02 版权所所有，侵权必究究第17页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 3.. 4..2 运算符和和优先级下面的表格中列出出了TCL中用到到的运算符，它们的语法形形式和用法跟跟ANSI C中很相相似。这里就就不一算符是按优先先级从高到低往往下排列的。同一格中的运运算符优先级级相同。一介绍。下表中的运算式语法形式 -a !a ~a a*b a/b a%b a+b a-b a<<b a>>b a<b a>b a<=b a>=b a= =b a!=b a&b a^b a|b a&&b a||b a?b:c 结果负a 非a 操作数类型操 i int,float i int,float i int i int,float i int,float i int i int,float i int,float i int i int i int,float,st tring i int,float,st tring i int,float,st tring i int,float,st tring i int,float,st tring i int,float,st tring i int i int i int i int,float i int,float a a:int,float 乘除取模加减左移位右移位小于大于小于等于大于等于等于不等于位操作与位操作异或位操作或逻辑与逻辑或选择运算 1..1 数学函数数 TCL支支持常用的数数学函数，表达达式中数学函函数的写法类似于C\C++语语言的写法，数数学函数的参参数可以是任意表达式，多个个参数之间用逗号隔开。例例如： %set x 2 2 % expr 2* sin($x<3) 1.68294196962 其中中expr是TCL的一个命令的，语法为： expr arg ?aarg ...? 2010-11--02 版权所所有，侵权必究究第18页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号两个个？之间的参数表示可可省，后面介介绍命令时对于可省参参数都使用这这种表示形形式。 expr可以有一个或多多个参数，它它把所有的参参数组合到一起，作为为一个表达式式，然后求值值： %exppr 1＋2*3 7 %exppr 1 +2 *3 7 需要要注意的一点点是，数学函函数并不是命命令，只在在表达式中出出现才有意义义。 TCL中支持的数数学函数如下下 abs( x) x Absolute vaalue of x. acos(( x) Arc cosine of o x, in the rannge 0 to p. asin( x) Arc sine of x, in the rangee -p/2 to p/2. atan( x) Arc tangentt of x, in the raange -p/2 to p//2. ngent of x/ y, in the range -pp/2 to p/2. atan22( x, y) Arc tan ceil( x) t x. Smallest intteger not less than x cos( x) Cosine of x ( x in radians). cosh(( x) Hyperbolic cosine of x. double( i) e to integeer i. Real value equal exp( x) e raised to the power x. floor(( x) Largest inteeger not greateer than x. fmodd( x, y) Floating-point remainder of x divided by b y. hypot( x, y) Square roott of ( x 2 + y 2 ). x int( x) Integer valuue produced byy truncating x. log( x) x Natural logaarithm of x. log100( x) Base 10 loggarithm of x. pow(( x, y) x raised to the t power y. roundd( x) Integer valuue produced byy rounding x. sin( x) x Sine of x ( x in radians). sinh( x) Hyperbolic sine of x. sqrt( x) Square roott of x. x tan( x) Tangent of x ( x in radianns). tanh(( x) Hyperbolic tangent of x. 2010-11--02 所有，侵权必究究版权所第19页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 TCL中有很多命命令都以表达达式作为参数数。最典型型的是expr命令，另外if、while、forr等循环控制命命令的循环控控制中也都使使用表达式式作为参数。 2 List list这这个概念在TC CL中是用来表表示集合的。T TCL中list是由由一堆元素组组成的有序集合合，list可以嵌嵌套定义，list每每个元素可以是是任意字符串串，也可以是llist。下面都是是TCL中的合合法的list： {} / //空list {a b c d} {a {bb c} d} //list可可以嵌套 list是是TCL中比较重重要的一种数数据结构，对于编写复杂的的脚本有很大大的帮助，TC CL提供了很多多基本命令对listt进行操作，下下面一一介绍绍： 2..1 list命令语法： list ? valuee value...? 个list，list的元元素就是所有有的value。例：：这个命令生成一个 % list 1 2 {3 4} 1 2 {3 4} 2..2 concat命命令: 语法:concat list ?liist...? 变成新list的一一个元素。这个命令把多个liist合成一个lisst，每个list变 2..3 lindex命令令语法：lindex list index i 元素。例：返回list的第index个(0-based)元 3 4}} 2 % liindex {1 2 {3 34 2..4 llength命命令语法：llength listt 数。例返回list的元素个数 % lleength {1 2 {3 4}} 3 2..5 linsert命令 2010-11--02 版权所所有，侵权必究究第20页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号语法：linsert list index i value ?vvalue...? 新串是把所有有的value参数值值插入list的第第index个(0-based)元素之前前得到。例: 返回一个新串，新 4 1 7 8 {99 10} % linnsert {1 2 {3 4}} 1 7 8 {9 10} 2 {3 4} 4 2..6 lreplace命命令: 语法：lreplace listt first last ?vallue value ...? 新串是把list的的第firs (0-based)t到第last 个(0-based)元个元素用所有的vvalue参数替换换得到返回一个新串，新数，就表示删删除第first到第第last个元素。例：的。如果没有value参数 { 10} 2 {3 4}}} 3 3 % lreeplace {1 7 8 {9 1 7 8 2 {3 4} % lreeplace {1 7 8 2 {3 4}} 4 4 4 5 6 1782456 2..7 lrange 命令: 命语法:lrange list first last ( 第last (0-based)元素组成的串,如果last的的值是end。就就是从第first个个直到返回list的第first (0-based)到第串的最后。例： % lraange {1 7 8 2 4 5 6} 3 end 2456 2..8 lappend命命令: 语法：lappend varrname value ?value...? ? 素附加到变量量varname后面面，并返回变变量的新值，如果varnamee不存把每个value的值作为一个元素在，就生成这个变量。例： % lapppend a 1 2 3 123 % sett a 123 2..9 lsearch 命令: 命语法：lsearch ?-ex xact? ?-glob? ?-regexp? list pattern 个匹配模式paattern的元素的的索引，如果果找不到匹配配就返回-1。 -exact、-globb、返回 list中第一个三种模式匹配配的技术。-exxact表示精确匹匹配；-glob的的匹配方式和和string match命命令的匹配方方式相 regexp是三 2010-11--02 版权所所有，侵权必究究第21页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号同，将在后面第八节介介绍string命令令时介绍；-reegexp表示正规规表达式匹配配，将在第八八节介绍regexpp命令 glob匹配。例例: 时介绍。缺省时使用-g % sett a { how aree you } how are you % lseearch $a y* 2 % lseearch $a y? -1 2..10 lsort命令令: 语法：lsort ?optio ons? list 串。options可以以是如下值：这个命令返回把liist排序后的串 -asciii 按ASCII字字符的顺序排序序比较.这是缺缺省情况。 -dictiionary 按字典典排序,与-asccii不同的地方方是： (1)不考虑虑大小写 (2)如果元元素中有数字的的话,数字被当当作整数来排排序. 因此：biigBoy排在biggbang和bigboyy之间, x10y 排在x9y和x11 排 1y之间. 元素转换成整整数,按整数排序. -integger 把list的元 -real 把list的元元素转换成浮点点数,按浮点数数排序. 符比较) -increeasing 升序(按ASCII字符 -decrreasing 降序序(按ASCII字符符比较) -com mmand comm mand TCL自动动利用commannd 命令把每两两个元素一一一比较,然后给出出排序结果。 2..11 split命令: 语法：split string ?splitChars? 分隔符splitChhars分成一个个单词，返回回由这些单词词组成的串。如如果splitCharss 把字符串string按分字符分开。如果果splitChars没没有给出,以空空格为分隔符。。例：是一个空字符{}，string被按字 ou" . % split "how.are.yo how are you ou" % split "how are yo how are you ou" {} % split "how are yo how{}are{}you 2010-11--02 版权所所有，侵权必究究第22页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 2..12 join命令 nString? 语法:join list ?join 命令是命令的的逆。这个命令令把list的所有有元素合并到到一个字符串中，中间以joinString分开开。缺 join命省的joinS String是空格。例： % joiin {h o w { } a r e { } y o u}} {} how are you y . % joiin {how are you} how.are.you 3 控制流 TCL中的控制流和和C语言类似，包括if、whhile、for、fooreach、switchh、break、coontinue等命令令。下面分别介绍。 3..1 if命令 b ?elseiff test2 body22 elseif.... ? ?else bodyn?? 语法： if test1 body1 先把test1当作作一个表达式式求值，如果值值非0，则把bbody1当作一个脚本执行并并返回所得值值，否 TCL先则把test2当当作一个表达达式求值，如果值非0，则把body2当作作一个脚本执行行并返回所得得值……。例如如： if { $x>0 } { ..... }eelseif{ $x＝＝＝1 } { ..... }eelseif { $x＝＝＝2 } { .... }eelse{ ..... } 一定要写在上上一行，因为如如果不这样，TCL 解释器器会认为if命令令在换行符处处已结注意，上例中'{'一一行会被当成新新的命令，从从而导致错误误的结果。在在下面的循环命命令的书写中中也要注意这这个问束，下一题。书写中还要注意的的一个问题是是if 和{之间应应该有一个空空格，否则TCL解释器会把把'if{'作为一个个整体而导致错误。当作一个命令名，从而 3..2 循环命令：while 、fo or、 foreach h 3.22.1 while命令令 2010-11--02 版权所所有，侵权必究究第23页，共共76页 TCL培训教程程(全) 语法为: 绝密请输入文档档编号 while test body 是一个脚本，如果表达式的的值非0，就运运行脚本，直直到表达式为00才停参数test是一个表达式，body是令中断并返回回一个空字符串串。止循环，此时while命令例如：假假设变量 a 是一一个链表，下下面的脚本把a 的值复制到到b： set b " " set i [eexpr [llength $a] -1] while { $i>=0}{ nd b [lindex $aa $i] lappen incr i -1 } 3.22.2 for命令语法为: for init teest reinit bodyy 第二个参数teest是一个表达达式，用来决定循环什么时时候中断，第第三个参数init是一个初始化脚本，第初始化的脚本本，第四个参数数body也是脚脚本，代表循环环体。下例与与上例作用相同：参数reinitt是一个重新初 set b " " for {seet i [expr [llenggth $a] -1]} {$$i>=0} {incr i -1} { lappend b [llindex $a $i] } 3.22.3 foreach命令语法形式这个命令有两种语 1。 foreach varN Name list bodyy 变量，第二个参数list 是一一个表(有序集集合)，第三个个参数body是是循环第一个参数varNaame是一个变一个元素，都都会执行循环体体一次。下例例与上例作用相同：体。每次取得链表的一 set b " " foreach h i $a{ set b [linsert $b 0 $i] } f varlistt1 list1 ?varlistt2 list2 ...? Boody 2。 foreach 这种形式包含了第第一种形式。第一个参数数varlist1是一个循环变量列列表，第二个个参数是一个个列表量会分别取listt1中的值。boody参数是循环环体。 ?varlisst2 list2 ...?表示示可以有多个个变量 list1，varlist1中的变量例如：列表和列表对出现。例 2010-11--02 版权所所有，侵权必究究第24页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 set x {} foreaach {i j} {a b c d e f} { lapppend x $j $i } 这时总共有三次循循环，x的值为为"b a d c f e"。 set x {} foreaach i {a b c} j {d e f g} { lapppend x $i $j } 这时时总共有四次次循环，x的值为"a d b e c f {} g"。 set x {} foreaach i {a b c} {jj k} {d e f g} { lapppend x $i $j $k $ } 这时总共有三次循循环，x的值为为"a d e b f g c {} {}"。 3.22.4 break和coontinue命令在循循环体中，可以用break和ccontinue命令中中断循环。其其中break命令令结束整个循环环过程，并从从循环中跳出，continue只是结束本次循环环。 3.22.5 switch 命令令和C语语言中switch语句一样，T TCL中的switcch命令也可以以由if命令实现现。只是书写写起来较为烦烦琐。 switch命令令的语法为: switch ? optioons? string { pattern p body ? pattern body ...?} 第一一个是可选参数options，表表示进行匹配配的方式。TC CL支持三种匹匹配方式：-exxact方式，-gglob方式，-regeexp方式,缺省情情况表示-gloob方式。-exacct方式表示的的是精确匹配，，-glob方式的的匹配方式和和string match 命令令的匹配方式式相同(第八节节介绍)，-regeexp方式是正规规表达式的匹匹配方式(第八八节介绍)。第第二个参数stringg 是要被用来来作测试的值，第三个参数数是括起来的一一个或多个元元素对，例： switcch $x { a b {inccr t1} c {inccr t2} defaultt {incr t3} 2010-11--02 版权所所有，侵权必究究第25页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 } 其中a的后面跟一个'－'表示使用和下一个模模式相同的脚脚本。default表表示匹配任意意值。一旦swiitch命令找到一一个模式匹配，，就执行相应应的脚本，并返返回脚本的值值，作为switcch命令的返回回值。 3..3 eval命令命令是一个用用来构造和执行行TCL脚本的的命令，其语法法为： eval命 eval arg a ?arg ...? 它可以接收一个或或多个参数，然后把所有的参数以空格格隔开组合到到一起成为一个个脚本，然后后对这如：个脚本进行求值。例如％evval set a 2 ;seet b 4 4 3..4 source命命令 sourcce命令读一个个文件并把这个个文件的内容容作为一个脚本本进行求值。例如： sourcce e:/tcl&c/helllo.tcl 注意路径的描述应应该和UNIX相相同，使用'/'而而不是'\'。 cedure) 4 过程(proc TCL支持过程的支的定义和调用用，在TCL中,过程可以看看作是用TC CL脚本实现的的命令，效效果与 TCL的固固有命令相似似。我们可以以在任何时候候使用proc命令定义自命己的过程，TCL中的过过程类似于C中的函数。 4.1 过程定义义和返回值 TCL中过程是由由proc命令产生生的：例如如： % prooc add {x y } {expr $x+$y}} proc命令的第一命一个参数是你你要定义的过过程的名字字，第二个参参数是过程的的参数列表表，参数之间用用空格隔开，，第三个参参数是一个TC CL脚本，代代表过程体。 proc生成一一个新的命命令，可以象固固有命令一样样调用： % addd 1 2 3 2010-11--02 版权所所有，侵权必究究第26页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号在定定义过程时，，你可以利用return命令令在任何地方方返回你想要的值。 return r 命令迅迅速中断过程，并把它的参参数作为过程程的结果。例如： % prooc abs {x} { if {$xx >= 0} { retu urn $x } returnn [expr -$x] } 过程程的返回值是是过程体中最最后执行的那那条命令的的返回值。 4.2 局部变量量和全局变量量对于于在过程中定定义的变量，因为它们们只能在过程程中被访问，并且当过程程退出时会会被自动删除，所以称为局局部变量；在所有过程程之外定义的的变量我们称称之为全局局变量。TCL L中，局部变量量和全局变量量可以同名，两者的作作用域的交集集为空：局部部变量的作用用域是它所所在的过程的内内部；全局变变量的作用域域则不包括括所有过程的的内部。这一一点和C语言言有很大的不不同. 如果果我们想在过过程内部引用用一个全局局变量的值，可以使用global g 命令。例如： % sett a 4 4 % prooc sample { x } { gllobal a inncr a reeturn [expr $a+ +$x] } mple 3 % sam 8 %set a 5 全局局变量a在过过程中被访问问。在过程中中对a的改变变会直接反映映到全局上。。如果去掉掉语句 global a, TCL会出错，因会因为它不认识识变量a. 4.3 缺省参数数和可变个数数参数 TCL还提供三种还种特殊的参数数形式：首先先，你可以定定义一个没有有参数的过程程，例如： 2010-11--02 版权所所有，侵权必究究第27页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 proc add {} { exprr 2+3} 其次次，可以定义义具有缺省参参数值的过程，我们可可以为过程的的部分或全部部参数提供供缺省值，如果果调用过程时时未提供那些些参数的值值，那么过程程会自动使用用缺省值赋给给相应的参参数。和C\C++中具有缺省省参数值的函函数一样，有有缺省值的的参数只能位位于参数列表表的后部，即在第一个具具有缺省值的的参数后面的所有参数数，都只能是是具有缺省值值的参数。例如如： proc add {val1 {vaal2 2} {val3 3}}{ 3 expr $vaal1+$val2+$vaal3 } 则： add 1 //值为6 2 add 2 20 //值为25 add 4 5 6 //值为15 1 另外外，TCL的过过程定义还支支持可变个数数的参数，如果过程的的最后一个参参数是args, 那么就表示这这个过程支持持可变个数的参数调用用。调用时,位于位 args以前前的参数象普普通参数一一样处理，但任任何附加的参参数都需要要在过程体中中作特殊处理理，过程的局部变量arrgs将会被设设置为一个列表表，其元素就就是所有附附加的变量。如果没有附附加的变量，args就设置置成一个空空串，下面是一一个例子： prroc add { vall1 args } { set sum s $val1 foreach i $args { incr sum $i } n $sum return } 则： addd 2 //值为2 addd 2 3 4 5 6 ///值为20 4.4 引用：u upvar 2010-11--02 版权所所有，侵权必究究第28页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号命令令语法:upvar ?level? ? otherV Var myVar ?ottherVar myVaar ...? upvarr命令使得用用户可以在过过程中对全局局变量或其其他过程中的的局部变量进进行访问。 upvar 命令的第第一个参数otherVar o 是我我们希望以引引用方式访问问的参数的名名字，第二二个参数myV Var 是这个过程程中的局部变变量的名字，一旦使用用了upvar 命令令把otherVarr 和myVar 绑定绑 ,那么在在过程中对局部部变量myVarr 的读写就相相当于对这个个过程的调用者中otherrVar 所代表的局部变量量的读写。下面面是一个例子子： % prooc temp { arg g}{ uppvar $arg b seet b [expr $b b+2] } % prooc myexp { var } { seet a 4 teemp a reeturn [expr $v var+$a] } 则： % myyexp 7 13 这个个例子中，upvar u 把$arg((实际上是过过程 myexp中的变量中 a)和过程和 temp 中的变量中 b 绑定，绑对b的读写写就相当于于对a的读写。。 upvarr 命令语法中中的 level 参数数表示：调调用 upvar 命令令的过程相相对于我们希希望引用的变量 myVar在调调用栈中相相对位置。例例如： upvarr 2 other x 这个个命令使得当当前过程的调用者的调调用者中的变变量 other，可可以在当前前过程中利用用x访问。缺省省情况下，level l 的值为1，即当前过过程(上例中中的temp)的调调用者(上例例中的myexp))中的变量(上例例中myexp的a)可以在当当前过程中利利用局部变量量(上例中tem mp的b)访问。如果果要访问全局局变量可以这这样写： upvarr ＃0 other x 2010-11--02 所有，侵权必究究版权所第29页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号那么么，不管当前前过程处于调调用栈中的的什么位置，都可以在当前过程中中利用x访问全局变量otherr。 5 字符串操操作因为为TCL把所有有的输入都当当作字符串看待，所以以TCL提供了了较强的字符符串操作功能， TCL中与与字符串操作作有关的命令令有：string、format、reegexp、regsubb、scan等。 5.1 format命命令语法法：format forrmatstring ?vvlue value...? formaat 命令类似于 ANSIC 中的 sprintf 函数数和 MFC 中 CString C 类提供供的 Format 成员函数。成它按 formatstrinng提供的格格式，把各个个value的值组组合到formattstring中形成成一个新字符符串，并返返回。例如： %set name john John %set age 20 20 y old" $naame $age] %set msg [formaat "%s is %d years d john is 20 years old 5.2 scan命令令语法法：scan strinng format varrName ?varN Name ...? scan 命令可以认命认为是 format 命令的逆，命其功能类似似于 ANSI C 中的 sscanf函数。它按函 f format 提供的格格式分析 striing 字符串，然后把结果存到变量量 varName 中 , 注意除了空空格和 TAB 键之外，strinng 和format中的字符和中 '% %'必须匹配。例如： % scaan "some 26 34" "some %d %d" % ab 2 % sett a 26 % sett b 34 % scaan "12.34.56.78" "%d.%d..%d.%d" c d e f 2010-11--02 版权所所有，侵权必究究第30页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 4 he value of c is %d,d is %d,e is %d ,f is %d" $c $d $ee $f] % puuts [format "th the value v of c is 12,d 1 is 34,e is 56 ,f is 78 scan命命令的返回值值是匹配的变量量个数。而且且，我们发现现，如果变量vvarName不存在在的话，TCL L会自动声明该变量。 5..3 regexp命命令语法：regexp ?sw witchs? ?--? expp string ?matchVar?\ ?subM MatchVar subMatchVar...? 判断正规表达式式exp是否全部部或部分匹配配字符串stringg，匹配返回11，否则0。 regexxp命令用于判在正规表达式中，一些字符具具有特殊的含义义，下表一一一列出，并给予予了解释。字符符意义匹配任意意单个字符表示从头头进行匹配表示从末末尾进行匹配配匹配字符符x，这可以抑制字符x的的含义匹配字符符集合chars中中给出的任意意字符，如果cchars中的第第一个字符是是^，表示匹配任意意不在charss中的字符，chars 的表示方法法支持a-z之之类的表示。把regexp作作为一个单项项进行匹配对*前面的的项0进行次或多次匹配配对＋前面的的项进行1次次或多次匹配配对？前面的的项进行0次次或1次匹配配匹配regexpp1或regexp22中的一项 . ^ $ \x [chars]] (regexp) * + ? regexp1|regexp2 是从《Tcl andd Tk ToolKit》中摘下来的，下面进行说说明：下面的一个例子是 ^((0 0x)?[0-9a-fA-F]+|[0 0-9]+)$ 这个正规表达式匹匹配任何十六六进制或十进制制的整数。以|分开(0x)？[0-9a-fA A-F]+和[0-9 9]+，表示可可以匹配其中的的任何一个，事实两个正规表达式以上前者匹配十六进制，后者匹配的十进制。示必须从头进行匹配，从而而上述正规表表达式不匹配jkk12之类不是以0x或数字开开头的串。 ^表示 2010-11--02 版权所所有，侵权必究究第31页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号＄表示必须从末尾尾开始匹配，从而上述正规规表达式不匹匹配12jk之类不不是数字或a-ffA-F结尾的串串。 0-9a-fA-F]+ 进行说明，，(0x)表示0xx一起作为一项项，?表示前一一项(0x)可以出现0 下面以(0x)？[0 A-F]表示可以是任意0到9之间的单个个数字或a到f或或A到F之间的的单个字母，＋表次或多次，[0-9a-fA 数字或字母可可以重复出现一一次或多次。示象前面那样的单个数 % reggexp {^((0x)?[0-9a-fA-F]+|[0-9]+)$} ab 1 % reggexp {^((0x)?[0-9a-fA-F]+|[0-9]+)$} 0xxabcd 1 % reggexp {^((0x)?[0-9a-fA-F]+|[0-9]+)$} 123345 1 % reggexp {^((0x)?[0-9a-fA-F]+|[0-9]+)$} 1223j 0 后面有参数maatchVar和subM MatchVar，则则所有的参数数被当作变量名名，如果变量量不存如果regexp命令后 gexp把匹配整整个正规表达式的子字符串串赋给第一个个变量，匹配正正规表达式的的最左在，就会被生成。 reg 符串赋给第二二个变量，依次次类推，例如如：边的子表达式的子字符 +) *([a-z]+)} " there is 1000 apples" totaal num wordd % reggexp { ([0-9]+ 1 % puuts " $total ,$nu um,$word" 100 apples ,100,aapples regexxp可以设置一一些开关（swiitchs〕，来控控制匹配结果： -nocaase 匹配时不不考虑大小写 -indicces 改变各个个变量的值，这是各个变量量的值变成了了对应的匹配配子串在整个字字符串中所处处位置的索引。例如： % reegexp -indicess { ([0-9]+) *(([a-z]+)} " theere is 100 apples" total nuum word 1 % puuts " $total ,$nu um,$word" 9 20 ,10 12,15 20 正好子串“ 100 ap pples”的序号是是9-20,"100"的的序号是10-112,"apples"的序序号是15-20 -- 表示这后面再没表没有开关（sswitchs〕了，即使后面有以'-'开头的参参数也被当作正正规表达式的的一部分。 1..1 regsub命命令语法：regsub ?sw witchs? exp striing subSpec varname v 2010-11--02 版权所所有，侵权必究究第32页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 regsuub的第一个参参数是一个整个个表达式，第第二个参数是一个输入字符符串，这一点点和regexp命令令完全一样，也是当匹配时返返回1，否则返返回0。不过rregsub用第三三个参数的值来来替换字符串串string中和正正规表四个参数被认认为是一个变量量，替换后的的字符串存入这这个变量中。例如：达式匹配的部分，第四 They live theree lives " their x % reggsub there "T 1 % puuts $x Theyy live their livees 这里there被用theiir替换了。几个开关(switcchs): regsuub命令也有几 -nocaase 意义同reg gexp命令中。 -all 没有这个开关关时，regsub只替换第一个个匹配，有了这个开关，reegsub将把所有有匹配的地方方全部替换。意命令中。 -- 意义同regexp命 1.2 string命命令 string命令的语法法：string o option arg ?aarg...? string命令具有强强大的操作字符串的功能，，其中的optiion选项多达220个。下面介介绍其中常用用的部分。 1.22.1 string com mpare ?-noca ase? ?-length int? string1 sttring2 把字字符串string1和和string2进行行比较,返回值为-1、0或1,分分别对应strinng1小于、等于或大于strinng2。如果有 -llength 参数，那么只比较较前 int 个字符符，如果 int 为负数，那么么这个参数被被忽略。如果果有 nocase参数数，那么比较较时不区分大小小写。 1.22.2 string equal ?-nocase?? ?-length innt? string1 striing2 把字字符串string1和和string2进行行比较，如果两者相同，返返回值为1，否则返回0。其他参数与与8.5.1 同。 1.22.3 string firrst string1 strin ng2 ?startindeex? 在strring2 中从头查找与string11匹配的字符序列，如果找找到，那么就就返回匹配的第第一个字母所所在的位置(0-baased)。如果没没有找到，那那么返回-1。如如果给出了sttartindex变量量，那么将从sstartindex处开开始查找。例如： % strring first ab defabc 3 2010-11--02 版权所所有，侵权必究究第33页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 % strring first ab defabc 4 -1 1.22.4 string in ndex string cha arIndex 返回回string 中第ch harIndex个字符符(0-based)。charIndex可以以是下面的值值：整数数n: 字符串中第第n个字符(0--based) end : 最后一个字符－整数n：倒数数第n个字符。。string indexx "abcd" end-11 返回字符'c' end－如果果charIndex小于于0，或者大于于字符串strinng的长度，那那么返回空。例如: % strring index abcdef 2 c % strring index abcdef end-2 d 1.22.5 string laast string1 strring2 ?startinndex? 参照8.5.3.唯一的区区别是从后往往前查找 1.22.6 string leength string g 返回字符串string的的长度. 1.22.7 string maatch ?-nocase?? pattern stringg 如果果pattern 匹配sstring,那么返回1,否则返回回0.如果有-noccase参数,那么么就不区分大小小写. 在patttern 中可以使使用通配符: * 匹配string中中的任意长的任任意字符串,包包括空字符串串. ? 匹配string中中任意单个字符符集合chars中给给出的任意字符,其中可以使使用 A-Z这种种形式 [charrs] 匹配字符集 \x 匹配单个字字符x,使用'\'是为了让x可以为字符*,-,[,].. 例子: a % string match * abcdef 1 % strring match a* abcdef 1 def abcdef stringg match a?cd 2010-11--02 版权所所有，侵权必究究第34页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 1 % strring match {a[[b-f]cdef} abccdef //注意一一定药用'{',否则则TCL解释器器会把b-f当作命命令名 //从而导导致错误 1 % strring match {a[[b-f]cdef} acccdef 1 1.22.8 string raange string first f last 返回回字符串string g中从第first个个到第last个字字符的子字符符串(0-based)。。如果first<00，那么first被被看作 0，如果laast大于或等于于字符串的长度度，那么last被被看作end，如如果first比lasst大，那么返回空。 1.22.9 string reepeat string count 返回回值为：重复了了string字符串串count次的字字符串。例如： % strring repeat "ab bc" 2 abcabbc 1.22.10string reeplace strin ng first lastt ?newstring? 返回值为：从字符串 stringg 中删除了第 first 到第 lasst 个字符 (0-bbased) 的字符串，如果给出了 newstring变变量，那么就就用newstringg替换从第firsst到第last个字字符。如果firrst<0，那么fiirst被看作0，如果 last大于或或等于字符串的长度，那么么last被看作eend，如果first比last大或者者大于字符串串string的长度度或者 last小于0，，那么原封不不动的返回striing 。 1.22.11string toolower string g ?first? ?last? 返回回值为：把字字符串string转转换成小写后的字符串，如如果给出了first和last变量量，就只转换ffirst和 last之间的的字符。 1.22.12string tooupper string g ?first? ?last? 同88.5.11。转换成成大写。 1.22.13 string trrim string ?chars? 返回回值为:从striing字符串的首尾删除掉了字符集合cchars中的字符符后的字符串串。如果没有有给出 chars，那那么将删除掉spaces、tabs、newlines、caarriage returnss这些字符。例例如: % strring trim "abcd de" {a d e} bc % strring trim " def >" def 2010-11--02 版权所所有，侵权必究究第35页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 1.22.14string triimleft string ?chars? ? 同8.5.13。不过只只删除左边的的字符。 1.22.15string trimright striing ?chars? 同8.5.13。不过只只删除右边的的字符。 2 文件访问问 TCL提供了丰富提富的文件操作作的命令。通通过这些命令你可以对对文件名进行行操作(查找找匹配某一模式式的文件)、以顺序或随随机方式读写写文件、检检索系统保留留的文件信息息（如最后后访问时间)。 2.1 文件名 TCL中文件名和和我们熟悉的的windows表示示文件的方方法有一些区区别：在表示示文件的目录结构时它使使用 '/' ，而不不是 '\' ，这和和 TCL 最初是是在 UNIX 下实现有关。下。比如 C 盘 tcl 目录下的文件 sample.tcll在TCL中这样样表示：C://tcl/sample.tcll。件输入输出命命令 2.2 基本文件这个个名为tgrep的过程，可以的以说明TCL文件文 I/O的基本本特点： proc tgrep { patterrn filename} { set f [open $filenaame r] whilee { [gets $f liine ] } { if {[regexp $paattern $line]} { puts stdo out $line } } closee $f } 以上上过程非常象象UNIX的greep命令，你可以用两个你个参数调用它它，一个是模模式，另一一个是文件名，tgrep将打印印出文件中所所有匹配该模式的行。下面面介绍上述过过程中用到的的几个基本的文件输入入输出命令。 open n name ?accesss? 2010-11--02 版权所所有，侵权必究究第36页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 open n命令以acceess方式打开文件name。返回供其他他命令(gets,cllose等)使用的的文件标识识。如果name的第一个字符的符是“|”，管道道命令被触触发，而不是是打开文件。文件件的打开方式式和我们熟悉悉的C语言类类似，有以下下方式： r 只只读方式打开开。文件必须须已经存在在。这是默认认方式。 r+ 读写方式打开读开，文件必须须已经存在在。 w 只写方式打开只开文件，如果果文件存在在则清空文件件内容，否则则创建一新的空文件。 w+ 读写方式打开读开文件，如文文件存在则则清空文件内内容，否则创创建新的空文文件。 a 只写方式打开只开文件，文件件必须存在在，并把指针针指向文件尾尾。 a+ 读写方式打开读开文件，并把把指针指向向文件尾。如如文件不存在在，创建新的空文件。 open n命令返回一个字符串用于表识打开的文件。当调用别的命令（如： gets,puts,cclose，〕对打打开的文件件进行操作时时，就可以使使用这个文件件标识符。TCL有三个个特定的文件标标识： stdin,stdout和stderrr ，分别对应标准输入入、标准输出出和错误通道道，任何时时候你都可以使使用这三个文文件标识。读ffileId标识的文文件的下一行行，忽略换行符符。如果命令令中有varName就把 Name? gets fileId ?varN 该行的字符数数（文件尾返回回-1），如果果没有varNamee参数，返回文文件的下一行行作为该行赋给它，并返回该文件尾，就返返回空字符串））。命令结果（如果到了文和geets类似的命令令是read，不不过read不是是以行为单位位的，它有两两种形式：读读并返回 fileIdd标识的文件中所有剩下中如果没有noneewline 的字节。如 read ?-nonewline?? fileId 开关，则则在换行符处处停止。 read fileId numB Bytes 在fileIId标识的文件件中读并返回回下一个num mbytes字节。 puts ?-nonewlinee? ?fileId? strring puts命令把命 string写到写 fileId中，如果没有有nonewline开关的开话，添加加换行符。fiileId默认是stdout。命令返回值为一一空字符串。 puts命令使用命 C的标准的 I/O库的缓冲区方库方案，这就意意味着使用puts产生的信信息不会立立即出现在目标标文件中。如如果你想使数数据立即出出现在文件中中，那你就调调用flush命令令： 2010-11--02 所有，侵权必究究版权所第37页，共共76页 TCL培训教程程(全) flush h fileId 绝密请输入文档档编号把缓冲区内把容写到fileIdd标识的文件件中，命令返返回值为空字字符串。 flush命令迫使缓缓冲区数据写写到文件中。flush直到数据被写完完才返回。当当文件关闭时缓冲区数据据会自动flush。 closee ?fileId? 关闭标识为关 f fileId 的文件，命令返回回值为一空字字符串。这里里特别说明的的一点是，TCL T 中对串口口、管道、socket等的操操作和对文件件的操作类类似，以上对文文件的操作命命令同样适用用于它们。 2.3 随机文件件访问默认认文件输入输输出方式是连续的：即即每个 gets或爎或 ead 命令返返回的是上上次 gets或爎 ead e 访问位置后后面的字节节，每个 putss 命令写数据据是接着上上次 puts 写的的位置接着写写。 TCL 提供了 seek,tell和eof等命令使使用户可以非连续访问问文件。每个个打开的打开开文件都有访访问点，即下次读写开开始的位置。文件打开时时，访问点点总是被设置为为文件的开头头或结尾，这这取决于打打开文件时使使用的访问模模式。每次读读写后访问位置按访问的的字节数后移移相应的位数数。可以以使用seek命令来改变文文件的访问点点： seek fileId offset ?origin? 把fileIdd标识的文件件的访问点设设置为相对于于origin偏移移量为位置。origin可以是可 start，current，ennd，默认是start。命令的的返回值是一一空字符串。 offset的位例如如：seek fileIId 2000 改 fieleId标识的文件访改变标访问点，以便便下次读写开开始于文件件的第 2000个字字节。 seek 的第三个参参数说明偏移移量从哪开开始计算。第第三个参数必必为 start,currrent 或 end 中的一个。 startt是默认值：即偏移量是是相对文件件开始处计算算。 current 是偏移量从当是当前访问位位置计算。end是偏移量从是文件尾开始始计算。 tell fileId f 返回回fileId标识的的文件的当前前访问位置。。 eof fileId f 如果到达fileId标识的文件的标的末尾返回1，否则返回回0 。 2.4 当前工作作目录 2010-11--02 版权所所有，侵权必究究第38页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 TCL提供两个命提命令来管理当当前工作目录录：pwd和Cdd。 pwd和UNIX下的的pwd命令完全全一样，没有参数，返没返回当前目录录的完整路路径。 cd 命令也和命 UN NIX命令也一一样，使用一一个参数，可以把工作作目录改变为为参数提供供的目录。如果果 cd 没使用参数， UNIX X 下，会把工作目录变变为启动 TCL L 脚本的用户户的工作目录， WINDOW WS 下会把工工作目录变为为windows操作系统的安安装目录所在在的盘的根根目录(如：C:/) C 。值得注意意的是，提供供给cd的参数数中路径中的应该用'/'而不是而 '\'。如如 cd C:/TCL/lib。这是UNIX U 的风格。 2.5 文件操作作和获取文件件信息 TCL提供了两个提个命令进行文文件名操作：glob和file，用来操作文文件或获取文件信息。 glob命令采用一命一种或多种模模式作为参数数，并返回回匹配这个（些）模式的的所有文件件的列表，其语语法为： glob ?switches? paattern ?patternn ...? 其中中switches可以以取下面的值值： -nocoomplain ：允允许返回一个个空串，没有有-nocomplainn时，如果结结果是空的，就返回错误误。 -- ：表示switchees结束，即后后面以'-'开头头的参数将不不作为switchhes。 glob命令的模式命式采用string match m 命令(见8.5.7节)的匹匹配规则。例例如： %gloob *.c *.h main.c hash.c hassh.h 返回回当前目录中中所有.c或.hh的文件名。 glob 还允许许模式中包包含' 括在花括括号中间以以逗号分开的多多种选择'，例例如： %gloob {{src,backu up}/*.[ch]} src/m main.c src/hash h.c src/hash.hh backup/hashh.c 下面面的命令和上上面的命令等等价： glob {src/*.[ch]} {backup/*.[ch]]} 注意意：这些例子子中模式周围的花括号号是必须的，可以防止命命令置换。在调用globb命令对应的C过程前这些些括号会被TCL T 解释器去去掉。如果果glob的模式式以一斜线结结束，那将只只匹配目录名名。例如： 2010-11--02 版权所所有，侵权必究究第39页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 glob */ 只返返回当前目录录的所有子目目录。如果果glob返回的的文件名列表表为空，通常常会产生一个个错误。但是glob的在样样式参数之之前的第一个参参数是"-nocoomplain"的话话，这时即使使结果为空，glob也不会会产生错误。对文文件名操作的的第二个命令是file。fiile是有许多选项的常用用命令，可以以用来进行文件操作也可可以检索文件件信息。这这节讨论与名名字相关的选选项，下一一节描述其他他选项。使用用file 命令时，我们会发现现其中有很明显的UNIX X痕迹。 file atime nam me 返回一个十进制制的字符串，表示文件name n 最后被访访问的时间间。时间是以秒秒为单位从1970 1 年1月1日12：00AM开始计算。如果文件naame 不存在或或查询不到到访问时间就返返回错误。例例： % file atime license.txt 975945600 file copy ?-force? ?--? source file copy ?-force? ?--? source ?souurce ...? tarrget targgetDir 这个个命令把 sourrce 中指明的的文件或目录录递归的拷拷贝到目的地地址 targetDirr ，只有当存存在 force选项项时，已经存存在的文件才才会被覆盖盖。试图覆盖盖一个非空的的目录或以一一个文件覆覆盖一个目录或或以一个目录录覆盖一个文文件都会导导致错误。--的含义和前前面所说的一一样。 file delete ?--force? ?--?? pathname 命令删除pathnname指定的的文件 ?pathnamee ... ? 这个命或目录，当指定了-force 时，非非空的目录也也会被删除。即使没有有指定-force，只读文件，件也会不存在的文件件不会引发发错误。被删除。删除一个不 file dirname name 返回nam me中最后一个个“/”前的所所有字符；如如果 name 不包含不 “/”，返回回“.”；如果name n 中最后后一个“/”是第第name的第一一个字符，返回“/”。 file executable name 2010-11--02 如果果name对当前前用户是可以执行的，就返回1，否否则返回0。所有，侵权必究究版权所第40页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 nam me 如果name n 存在于当当前用户拥有搜索权限限的目录下返返回1，否则则返回 file extension na ame 返回name n 中最后的“.”以后（（包括这个小小数点）的所所有字符。如果 file exists 0。 name中没没有“.”或最后后斜线后没有有“.”返回空空字符。 file isdirectory name n 如果果name是目录录返回1，否否则返回0。如果naame是文件返返回1，否则返回0。 file isfile name file lstat name arrayName a 除了利用lsstat内核调用用代理stat内核核调用之外外，和file statt命令一样，这这意味着如果果name是一个个符号连接接，那么这个个命令返回的的是这个符号号连接的信信息而不是这个个符号连接指指向的文件件的信息。对对于不支持符号连接的的操作系统，，这个命令令和和 file stat命令一样。命 file mkdir dir ?dir ...? 这这个命令和 U UNIX 的mkdiir命令类似，创建dir中指指明的目录录。如果dir已经经存在，这个个命令不作任任何事情，也不返回错错误。不过如如果试图用一一个目录覆覆盖已经存在的的一个文件会会导致错误。这个命令令顺序处理各各个参数，如如果发生错误误的话，马马上退出。 file mtime m name 返回十进制的字字符串，表示示文件name最后被修改的最的时间。时时间是以秒为单单位从1970年1月1日12：00AM开始计计算。 file owned namee 如果naame被当前用用户拥有，返返回1，否则则返回0。 file readable nam me 如果当当前用户可可对name进行行读操作，返返回1，否则返回0。 2010-11--02 所有，侵权必究究版权所第41页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 file readlink na ame 返回name代表的符号连接接所指向的文文件。如果name n 不是符符号连接或者找找不到符号号连接，返回回错误。在在不支持符号号连接的操操作系统 ( 如 windows) 中选项 readlink没有定义。没 file rename ? -fforce? ?--? source s targeet file rename ?-fforce? ?--? source ?souurce ...? targgetDir 这个个命令同时具具有重命名和和移动文件件(夹)的功能。把source指定的文件或指或目录改名或移动到targeetDir下。只有当存在只 -fforce选项时，，已经存在在的文件才会会被覆盖。试图覆盖一试一个非空的目录录或以一个文文件覆盖一个个目录或以以一个目录覆覆盖一个文件件都会导致错错误。 file rootname name 返回name中最最后“.”以前（（不包括这个个小数点）的所有字符符。如果name中没有“ 中 .”返回回Name。 file size name 返回十进制字符串串，以字节表表示name的大大小。如果文文件不存在在或得不到name的大小，返返回错误。 file stat name arrayName 调用statt内核来访问问name，并设设置arrayNam me参数来保存存stat 的返回信信息。 arrayN Name被当作作一个数组，它将有以下下元素：atiime、ctime、dev、gid、ino、 mode、mtime m 、nlink、size、type和uid。除了了type以外，其其他元素都都是十进制的的字符串，tyype元素和file type t 命令的返返回值一样。。其它各个个元素的含义义如下： 2010-11--02 atime 最后后访问时间间. ctime 状态态最后改变变时间. dev 包含含文件的设设备标识. gid 文件件组标识. ino 设备备中文件的的序列号. mode 文件件的mode比特位比 . mtime 最后后修改时间间. nlink 到文文件的连接接的数目. size 按字字节表示的的文件尺寸. 所有，侵权必究究版权所第42页，共共76页 TCL培训教程(全) 程绝密请输入文档档编号文件件所有者的的标识. uid 这里里的atime、mtime m 、size元素与前面讨元讨论的file的选项有相同的同的值。要了了解其他元元素更多的信息息，就查阅stat s 系统调用用的文件；每每个元都直接接从相应statt返回的结构构域中得到。。文件操作的的stat选项提提供了简单的的方法使一次次能获得一一个文件的多多条信息。这这要比分多次调用file来获获得相同的信信息量要显显著的快。 file tail name file type name 返回namee中最后一个个斜线后的所所有字符，如如果没有斜斜线返回namee。返回文文件类型的字符串，返返回值可能能是下列中的的一个： file f 、 directory、characterspeecial、blockS Special、fifo、link或sockeet。 w nam me file writable 如果当前前用户对nam me可进行写写操作，返回回1，否则返回0。 3 错误和异异常错误误和异常处理理机制是创建建大而健壮的应用程序序的必备条件件之一，很多多计算机语语言都提供了错错误和异常处处理机制，TCL T 也不例外外。错误误 (Errors) 可以以看作是异常常 (Exceptionns) 的特例。 TCL 中，异异常是导致脚脚本被终止的事件，除了了错误还包括括break、conntinue 和returrn等命令。TCL T 允许程序序俘获异常，，这样仅有有程序的一部分分工作被撤销销。程序脚本本俘获异常常事件以后，可以忽略它它，或者从异异常中恢复复。如果脚本无无法恢复此异异常，可以把把它重新发发布出去。下下面是与异常常有关的TCL命令： catch h command ?vvarName? 这个命令令把command作为作 TCL脚本本求值，返回一个整型型值表明commaand结束的状状态。如果提提供varName参数，参 TCL将生成变量将 v varName ，用用于保存com mmand 产生的错错误消息。 errorr message ?inffo? ?code? 这个命命令产生一个个错误，并把把message作为为错误信息息。如果提供innfo参数，则则被用于初始始化全局变量errorInfo。如果提供code c 参数，将将被存储到到全局变量errorrCode中。 2010-11-02 版权所所有，侵权必究究第43页，共76页 TCL培训教程程(全) 绝密请输入文档档编号 returrn -code co ode ?-errorin nfo info? ?-errrorcode erroorCode? ?strinng? 这个命命令使特定定过程返回一个个异常。codde指明异常的的类型，必必须是ok,errorr,return,break,,continue或者者是一个整数数。errorinfo选项用于指定选定全局变量量errorInfo 的初初始值，-errrorcode用于指定全局变变量errorCodee的初始值。 string s 给出retuurn的返回值值或者是相关关的错误信息息，其默认值值为空。 3.1 错误当发发生一个TCL L错误时，当当前命令被终终止。如果果这个命令是是一大段脚本本的一部分分，那么整个脚脚本被终止。。如果一个个TCL过程在运行中发生生错误，那么么过程被终止止，同时调调用它的过程，以至整个调调用栈上的活活动过程都都被终止，并并返回一个错错误标识和一一段错误描描述信息。举个个例子，考虑虑下面脚本，它希望计算算出列表元元素的总和： set lisst {44 16 123 98 57} set suum 0 foreaach el $list { seet sum [expr $sum+$elemen $ nt] } ment": no suchh variable => caan't read "elem 这个个脚本是错误误的，因为没没有element这个变量。这 TCL分析expr命令时，会试图用element 变量的值值进行替换，，但是找不不到名字为ellement的变量量，所以会报报告一个错错误。由于fooreach 命令利用用TCL解释器器解释循环体体，所以错误误标识被返返回给foreach。foreach收到到这个错误误，会终止循环环的执行，然然后把同样的错误标识识作为它自己己的返回值返返回给调用者者。按这样样的顺序，将致致使整个脚本本终止。错误信息can't read "elemennt": no such variable v 会被一一路返回，并且很可能被被显示给用户户。很多多情况下，错错误信息提提供了足够的的信息为你指指出哪里以以及为什么发发生了错误。然而，如果果错误发生在在一组深层嵌嵌套的过程程调用中，仅仅仅给出错误误信息还不能能为指出哪哪里发生了错误误提供足够信息。为了了帮助我们指指出错误的的位置，当 TCL T 撤销程序序中运行的命令时，创建建了一个跟踪踪栈，并且且把这个跟踪踪栈存储到全全局变量errrorInfo中。跟跟踪栈中描描述了每一层嵌嵌套调用。例例如发生上面面的那个错错误后，errorrInfo有如下的的值： 2010-11--02 版权所所有，侵权必究究第44页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 can't read "elementt": no such varriable whhile executing "exprr $sum+$elem ment" ("fforeach" body line 2) invvoked from wiithin "foreach el $list { m [expr $sum+ +$element] set sum }"" 在全全局变量errorrCode中，TC CL还提供了了一点额外的的信息。erroorCode变量是是包含了一一个或若干元素素的列表。第第一个元素素标示了错误误类别，其他元素提供供更详细的相相关的信息。不过，errorrCode变量是是TCL中相对对较新的变量量，只有一部分处理文文件访问和子子过程的命命令会设置这个个变量。如果果一个命令产产生的错误误没有设置errrorCode变量量，TCL会填填一个NONE值。值当用用户希望得到到某一个错误误的详细的信信息，除了了命令返回值值中的错误信信息外，可可以查看全局变变量errorInfo和errorCode的值。的 3.2 从TCL脚脚本中产生错错误大多多数TCL错误误是由实现TCL T 解释器的的C代码和内内建命令的C代码产生的的。然而，通过执行TCL L命令error产生错误也是是可以的，见见下面的例子子： if {($$x<0)||($x>100 0)} { errror "x is out off range ($x)" } error命令产生了命了一个错误，并把它的参参数作为错误误消息。作为为一种编程的的风格，你应应该只在迫迫不得已终止止程序时下才才使用error命令。如果命果你认为错误很很容易被恢复复而不必终终止整个脚本本，那么使用通常的retturn机制声明明成功或失失败会更好（例例如，命令成成功返回某某个值，失败败返回另一个值，或者者设置变量来来表明成功功或失败）。尽尽管从错误误中恢复是可可能的，但但恢复机制比比通常的 retuurn 返回值机机制要复杂。因此，最好好是在你不想想恢复的情况况下才使用用error命令。 ch捕获错误误 3.3 使用catc 2010-11--02 版权所所有，侵权必究究第45页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号错误误通常导致所所有活动的TCL T 命令被终终止，但是是有些情况下下，在错误发发生后继续续执行脚本是有有用的。例如如，你用unset取消变量量x的定义，但但执行unsett时，x可能不不存在。如如果你用unset取消不存在的取的变量，会产产生一个错误： % unnset x can'tt unset "x": no o such variablee 此时时，你可以用用catch命令忽忽略这个错误误： % cattch {unset x} 1 CL脚本。如如果脚本正常常完成，cattch返回0。如如果脚本中发发生错误，catch catchh的参数是TC 会俘获错错误（这样保保证catch本身不被终止止掉）然后返返回1表示发发生了错误。。上面的例子忽略unset的任何错误，的这样如果x存在则被取取消，即使x以前不存在在也对脚本没没有任何影响响。 catchh命令可以有有第二个参数数。如果提供这个参数数，它应该是是一个变量名，catch把脚本把的返回值值或者是出错错信息存入这这个变量。 %catch {unset x} msg m 1 %set msg can't unset "x": no such variable 在这这种情况下，unset命令产产生错误，所以msg被设设置成包含了出错信息息。如果变量量x存在，那么么unset会成功功返回，这样catch的返返回值为0，msg m 存放unseet命令的返回回值，这里里是个空串。如如果在命令正正常返回时，你想访问问脚本的返回回值，这种形形式很有用；如果你想想在出错时利用用错误信息做做些什么，如如产生log文件，这种形文形式也很有用用。 3.4 其他异常常错误误不是导致运运行中程序被被终止的唯一形式。错错误仅是被称称为异常的一一组事件的的一个特例。除除了 error ， TCL T 中还有三三种形式的的异常，他们们是由 breakk 、 continue 和 return 命令产生的。所有有的异常以相相同的方式式导致正在执执行的活动脚本被终止止，但有两点点不同：首首先， errorInfo和errorCode只在错误异常只常中被设置；其次，除除了错误之外外的异常几乎乎总是被一一个命令俘获，不会波及其其他，而错误通常撤销销整个程序中中所有工作。。例如，breeak和continuee通常是被引入入到一个如foreach f 的循环环命令中；foreach将俘俘获break和coontinue异常，，然后终止止循环 2010-11--02 版权所所有，侵权必究究第46页，共共76页 TCL培训教程(全) 程绝密请输入文档档编号或者跳到到下一次重复复。类似地地，return通常常只被包含在在过程或者者被source引入入的文件中。过程实现和和source命令将俘获returnn异常。所有有的异常伴随随一个字符串串值。在错误情况，这这个串是错误误信息，在return r 方式，串是过程或脚脚本的返回值值，在break和continue方式，串是空方空的。 catchh命令其实可可以俘获所有有的异常，不仅是错误误。catch命令令的返回值表表明是那种种情况的异常，catch命令的的第二个参数数用来保存与异常相关关的串。例如如： %catch {return "all done"} stringg 2 %set string all done 下表表是对命令： catch com mmand ?varN Name? 的说明明。 catcch返回值 0 1 2 3 4 其他值描述正常返回回，varNam me给出返回值错误。 varName给出错误信息执行了rreturn命令，varName 包含过程程返回值或者返回给 source的的结果执行了break命令，varName 为空执行了continue命令令， varName为空用户或应应用自定义俘获获者无异常常 catch catch,sourrce,过程调用 catch,for,fforeach,w hile,过程 catch,for,fforeach,w hile,过程 catch 与caatch命令提供供俘获所有异异常的机制相相对应，retuurn可以提供供产生所有类类型异常。这里里有一个do命令的实现，命使用了catcch和return来正确处理异异常： prroc do {varNaame first last body} b { global errorIn nfo errorCodee upvar $varName v for {set v $fiirst} {$v <= $llast} {incr v} { switch [catch {uplevvel $body} striing] { 1 {reeturn -code errror -errorInfo $errorInfo \ 2010-11--02 版权所所有，侵权必究究第47页，共76页 TCL培训教程程(全) 绝密请输入文档档编号 -errorcodde $errorCode $string} 2 {rreturn -code reeturn $string} 3 reeturn } } } 这个个新的实现在在catch命令中中求循环体的值，然后后检查循环体体是如何结束束的。如果果没有发生异常 (0) ，或者异常是 continue(4) ，那么 do 继续下一个循环。如果发生 error(1) 或者 return(2)，那么do使用用return把异常传递到调调用者。如果果发生了breaak(3)异常，那么do正常常返回到调用者者，循环结束束。当doo反射一个errror到上层时时，它使用了了return的-errrorInfo选项，保证错误发发生后能够够得到一个正确确的调用跟跟踪栈。 -errrorCode 选项用于类似的的目的以传传递由 catch 命令得到的命初始 errorCode ，作为 do 命令的命 errorC Code 返回。如如果没有 -eerrorCode 选项项， errorCodde 变量总是得到 NONE值。 1 深入TCL L 本章章描述了一个个允许您查询询和操纵TC CL解释器内内部状态的命命令集。例如如，您可以通过这些命令令看一个变量量是否存在，可以查看看数组有哪些些入口(entry)), 监控所有对对变量的访访问操作，可以以重命名和删删除一个命令令或处理那那些未定义命命令的参考信信息。 1.1 查询数组组中的元素利用用array命令可可以查询一个个数组变量量中已经定义义了的元素的的信息。array命令的形形式如下： arrayy option arrrayName ?aarg arg ...? 由于于option的不同同，array命令有多种形形式。如果果我们打算开开始对一个数数组的元素素进行查询，我们可以先先启动一个搜索(search))，这可以由下下面的命令做做到： 2010-11--02 版权所所有，侵权必究究第48页，共共76页 TCL培训教程程(全) arrayy startseracch 绝密请输入文档档编号这个个命令初始化化一个对 naame 数组的所所有元素的搜索 arrayNam me (search)，返回一个搜搜索标识(seaarch identifierr)，这个搜索索标识将被用用于命令arrray nextelemeent、 array anyymore和array y donesearch h。 arrayy nextelemeent arrayNaame searchId 这个命命令返回arraayName的下一一个元素，如果 arrayName 的所有元素素在这一次次搜索中都已已经返回，那么返回一一个空字符符串。搜索标识必 array startserach h 的返回值。注意：如果对 arrayNaame 的元素进进行了添加或删 searchId 必须是除，那么么所有的搜索都会自动动结束，就象象调用了命命令 array donesearch 一样样，这样会导致 array nexxtelement操作作失败。 arrayy anymore arrayName a seearchId 如如果在一个搜搜索中还有元元素就返回1，否则返回回0 。 searchId 同上。这个命令对具有名字为空的元素的数组尤其有用，因为这时从 array nextelemeent中不能确确定一个搜索索是否完成。。 arrayy donesearch h arrayName searchId s 这这个命令中止止一个搜索，并销毁和这这个搜索有有关的所有状态态。searchId同上。命令令返回值为一一个空字符串。当一个个搜索完成时时一定要注意调用这个命命令。 arrayy命令的其他他option如下： arrayy exists arrrayName 如如果存在一个个名为arrayN Name的数组组，返回1，否否则返回0。 arrayy get arrayN Name ?pattern? 这个命命令的返回值值是一个元素素个数为偶数数的的list。我们可以从前前到后把相邻邻的两个元元素分成一个个个数据对，那么，每每个数据对的的第一个元元素是 arrayNamee 中元素的名名字，数据据对的第二个个元素是该数数据元素的的值。数据对对的顺序没有规律。如果果没有patternn参数，那么么数组的所有有元素都包含含在结果中中，如果有paattern参数，那么只有名字字和pattern匹配匹 (用string match的匹配配规则)的元元素包含在结结果中。如果果arrayNamee不是一个数组组变量的名字字或者数组中没有元素素，那么返回回一个空list。例：。 % sett b(first) 1 1 % sett b(second) 2 2 % arrray get b 2010-11--02 所有，侵权必究究版权所第49页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 seconnd 2 first 1 arrayy set arra ayName list 设置数组组arrayName的元素的值的。 list 的形式式和array get的返回值的的list形式一样样。如果arrrayName不存存在，那么生生成arrayNam me。例： % arrray set a {firrst 1 second 2} 2 % puuts $a(first) 1 % arrray get a seconnd 2 first 1 arrayy names arrayName a ? ?pattern? 这这个命令返回数组arrayyName中和模模式pattern匹配的匹元素的名名字组成的一一个list。如如果没有patteern参数，那那么返回所有有元素。如果果数组中没没有匹配的元素素或者arrayN Name不是一个个数组的名名字，返回一一个空字符串串。 arrayy size arrrayName 返回代代表数组元素素个数的一一个十进制的的字符串，如果 arrayNamee 不是一个数数组的名字，那么返回回0 。下面面这个例子通通过使用arraay names 和foreach f 命令，枚举了数数组所有的元元素： foreaach i [array names a] { p puts "a($i)=$ $a($i)" } 当然然，我们也可可以利用 staartsearch 、 anymore a 、 neextelement 、和 donesearcch 选项来遍历一个数组．这种方法比上面所给给出的 foreachh 方法的效率率更高，不不过要麻烦得得多，因此不常用。 1.2 info命令令 info命令提供了命查看TCL解释释器信息的的手段，它有有超过一打的的选项，详细细说明请参参考下面几节。 1.22.1 变量信息息 info命令的几个选命选项提供了了查看变量信信息的手段。 2010-11--02 版权所所有，侵权必究究第50页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 info exists varN Name 如如果名为 varN Name的变量在在当前上下文(作为全局局或局部变量量)存在，返回回1，否则返返回0。如果没有pattern p 参数，那么返回包包含所有全局局变量名字字的一 info globals ?pa attern? 个list。如如果有patternn参数，就只只返回那些和和pattern匹配配的全局变量量(匹配的方方式和string match m 相同)。 info locals ?pattern? 如如果没有 patteern参数，那那么返回包含含所有局部变变量(包括当当前过程的参数数)名字的一个list，globaal和upvar命令令定义的变量将不返回回。如果有paattern参数，就只返回那些些和pattern匹配的局部变匹变量(匹配的方方式和stringg match相同同)。 info vars ?patteern? 如果果没有patternn参数，那么么返回包括局局部变量和可可见的全局局变量的名字的的一个list。如如果有patterrn参数，就只只返回和模式pattern匹配配的局部变量量和可见全全局变量。模式式中可以用namespace n 来限限定范围，如:foo::option*，就只返返回namespacee中和option**匹配的局部和和全局变量。。 (注：tcl800以后引入了了namespace概念，不过概我们一般编编写较小的TCL程序，可以以对namespacce不予理睬，，用兴趣的话可以查找找相关资料。) 下面面针对上述命命令举例，假假设存在全局局变量globaal1和global2，并且有下列列的过程存存在: proc test {arg1 arg2} { global global1 set local1 1 set local2 2 ... } 然后后在过程中执执行下列命令令: % innfo vars global1 arg1 arg2 local2 local1 不 //global2不可见 % innfo globals global2 global1 % innfo locals arg1 arg2 local2 lo ocal1 % innfo vars *al* global1 local2 local1 2010-11--02 所有，侵权必究究版权所第51页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 1.11.1 过程信息息 info 命令的另外外的一些选项项可以查看过过程信息。 info procs ?patterrn? 如果没没有pattern参数，命令返参返回当前nam mespace中定义义的所有过过程的名字。如如果有 patterrn 参数，就只返回那些些和 pattern 匹配的过程的匹的名字 ( 匹配配的方式和 string s match相同同)。 info body procna ame a procnam me info args 返回回过程procnam me的过程体体。 procnamee必须是一个个TCL过程。返回包包含过程proccname的所有有参数的名字字的一个listt。 procnamee必须是一个TCL过程。 v info default procname arg varname procname必须须是一个TCL L过程， arg必须是这个必个过程的一个变变量。如果arg a 没有缺省省值，命令返返回0；否则则返回1，并并且把arg的缺缺省值赋给给变量 varname。 info level ?numb ber? 如果果没有numberr参数，这个个命令返回当当前过程在调调用栈的位位置。如果有nuumber参数，那么返回的的是包含在调用栈的位在位置为numbeer的过程的过过程名及其其参数的一个list。下面面针对上述命命令举例: procc maybeprint {a b {c 24}} { if {$a<$b} { p stdout "c is $c" puts } } % inffo body maybeeprint if {$a<$b} { p stdout "c is $c" puts } % inffo args maybeeprint abc ybeprint a x % inffo default may 0 ybeprint a c % innfo default may 2010-11--02 版权所所有，侵权必究究第52页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 1 %seet x 24 下面面的过程打印印出了当前的调用栈，并显示了每每一个活动过过程名字和参参数： proc printStack{}{{ s level [info level] set f {set i 1} {$ for $i<$level} {inncr i} { puts "Levell $i:[info levell $i]" } } 1.11.2 命令信息息 info 命令的另外命外选项可以查查看命令信息息。 info commands ?p pattern? 如果没有参参数pattern，这个命令返返回包含当前前namspace中所有固有、扩扩展命令以及及以proc命令令定义的过过程在内的所所有命令的名名字的一个个list。patternn参数的含义和和info procs一样。一 info cmdcount 返回了一一个十进制字字符串，表明明多少个命令曾在解释释器中执行过过。 info complete command 如如果命令是 c command 完整整的，那么返返回1，否则则返回0。这这里判断命令是是否完整仅判判断引号，括括号和花括括号是否配套套。 info script 如果当前有有脚本文件正在Tcl解释释器中执行，则返回最内层处于激激活状态的脚本本文件名；否否则将返回一一个空的字字符串。 1.11.3 TCL的版版本和库 info tclversion info library 返回为Tccl解释器返回回的版本号，，形式为maajor.minor，例例如8.3。返回Tcl库目录的完完全路径。这个目录用用于保存Tcl所使用的标所标准脚本，TCL L在初始化时时会执行这个个目录下的脚脚本。 1.11.4 命令的执行时间 TCL提供提 time命令令来衡量TC CL脚本的性能能： 2010-11--02 版权所所有，侵权必究究第53页，共共76页 TCL培训教程程(全) time script ?coun nt? 绝密请输入文档档编号这个命命令重复执执行script脚本本count次。再把花费的再总时间的用用count 除，返回回一次的平均均执行时间，单位为微微秒。如果没没有count参数数，就取执行行一次的时间。 1.11.5 跟踪变量 TCL提供了提 tracee命令来跟踪踪一个或多个个变量。如如果已经建立立对一个变量量的跟踪，则不论什么时时候对该变量量进行了读读、写、或删删除操作，就就会激活一一个对应的Tcl T 命令，跟跟踪可以有很多多的用途： 1.监视视变量的用用法（例如打打印每一个读读或写的操作作）。 2.把变变量的变化化传递给系统统的其他部分分（例如一一个TK程序中中，在一个小小图标上始始终显示某个变变量的当前值值）。 3.限制制对变量的的某些操作（例如对任何何试图用非非十进制数的的参数来改变变变量的值值的行为产生一一个错误。））或重载某些些操作（例例如每次删除除某个变量时时，又重新创创建它）。 tracee命令的语法法为： tracee option ?arg arg ...? 其中中option有以下下几种形式： tracee variable name ops command 这个命令设设置对变量name n 的一个跟跟踪：每次次当对变量name作ops操作时，就会执执行command命令。命 namee可以是一个个简单变量，，也可以是是一个数组的元元素或者整个个数组。 ops可以是以下几可几种操作的一一个或几个个的组合： r 当变量被读时当时激活commaand命令。 w 当变量被写时当时激活comm mand命令。 u 当变量被删除当除时激活com mmand命令。通过用unseet命令可以显显式的删除一一个变量，一个过程调用用结束则会隐隐式的删除所所有局部变变量。当删除除解释器时也也会删除变量量，不过这这时跟踪已经不不起作用了。。当对对一个变量的的跟踪被触触发时， TCL L 解释器会自自动把三个参数添加到到命令 commaand 的参数列表表中。这样command c 实际际上变成了 comm mand name1 name2 n op 2010-11--02 版权所所有，侵权必究究第54页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号其中中op指明对变变量作的什么么操作。nam me1和name2用于指明被用被操作的变量量：如果变变量是一个标量量，那么nam me1给出了变变量的名字，而name2是一个空字符是符串；如果变变量是一个个数组的一个元元素，那么 name1 给出数数组的名字字，而 name2 给出元素的给的名字；如果果变量是整个数组，那么么 name1 给出出数组的名字字而 name2 是一个空字符是符串。为了了让你很好的的理解上面的叙述，下面面举一个例子子： trace variable collor w pvar p trace variable a(length) w pvar proc pvar {name ellement op} { i {$element != if =""} { set name ${name}($elem ment) } u upvar $name x p "Variablee $name set to $x" puts } 上面面的例子中，对标量变量量color和数数组元素a(lenngth)的写操作作都会激活活跟踪操作pvvar。我们看到到过程pvar有三个参数，有，这三个参参数TCL解释释器会在跟踪踪操作被触发发时自动传传递给 pvar。比如如果我们们对color的值值作了改变，那么激活的的就是pvar color c "" w。我我们敲入： % sett color green Variaable color set to t green greenn comm mand 将在和触发跟踪操操作的代码同同样的上下文中执行：如果对被跟跟踪变量的访问是在一个个过程中，那那么commandd就可以访问问这个过程的的局部变量量。比如： proc Hello { } { set a 2 trace variable b w { puts $a ;list } set b 3 } % Heello 2 3 2010-11--02 所有，侵权必究究版权所第55页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号对于于被跟踪变量量的读写操作，commannd是在变量被读之后，而返回变量量的值之前前被执行的。因因此，我们可可以在comm mand对变量的的值进行改改变，把新值值作为读写的的返回值。而且因为在执执行commandd时，跟踪机机制会临时失失效，所以在在command中对变量进行中行读写不会会导致 command被递归激活被活。例如： % traace variable b r tmp % prooc tmp {var1 var2 v var3 } { upvarr $var1 t incr t 1 } % sett b 2 2 % puuts $b 3 % puuts $b 4 如果果对读写操作作的跟踪失败，即comm mand 失败，那么被跟踪踪的读写操作作也会失败败，并且返回和和command同样的失败信同信息。利用这这个机制可可以实现只读读变量。下面面这个例子子实现了一个值值只能为正整整数的变量： trace variable size w forceInt me element opp} { proc forceInt {nam upvvar $name x if ![regexp {^[0-9 9]*$} $x] { e error "value must m b a postivee integer" } } 如果果一个变量有有多个跟踪信信息，那么各个跟踪被被触发的先后后原则是：最最近添加的的跟踪最先被触触发，如果有有一个跟踪发发生错误，后面的跟踪踪就不会被触触发。 tracee vdelete name n ops coommand 删除对变量naame的ops操作作的跟踪。返返回值为一一个空字符串。 2010-11--02 所有，侵权必究究版权所第56页，共共76页 TCL培训教程程(全) tracee vinfo nam me 绝密请输入文档档编号这个命命令返回对变量的跟踪踪信息。返回回值是一个list，list的每每个元素是一个个子串，每个个子串包括两个元素：跟踪的操作作和与操作关关联的命令。如果变量量name 不存在或或没有跟踪信信息，返回一一个空字符符串。 1.11.6 命令的重重命名和删除 renam me 命令可以以用来重命名名或删除一个个命令。 renam me oldNamee newName 把命令oldN Name改名为为newName，如果newNam me为空，那那么就从解释器器中删除命令令oldName。下面面的脚本删除除了文件I/O命令：命 foreeach cmd {open close read gets puts} { rename $cmd {} } 任何何一个Tcl命令令都可以被重重命名或者者删除，包括括内建命令以以及应用中定定义的过程程和命令。重命命名一个内建建命令可能能会很有用，例如，exitt命令在Tcl中被定义为立中立即退出过过程。如果某个个应用希望在在退出前获得得清除它内内部状态的机机会，那么可可以这样作： renaame exit exit.o old procc exit status { appplication-speccific cleanup ... exxit.old $status } 在这这个例子中，exit命令被被重命名为 exit.old e ，并且且定义了新的 exit 命令，这个新命命令作了应用必必需的清除工工作而后调调用了改了名名字的exit命令来结束进命进程。这样在在已存在的的描述程序中调调用exit时就会有机会做做清理应用状状态的工作。。 1.11.7 unknownn命令 unkn nown命令的语法为： unkn nown cmdNa Name ?arg arg ...? 当当一个脚本试试图执行一个不存在的的命令时，TCL解释器会激激活 unknow wn 命令，并把那个不存存在的命令令的名字和参参数传递给给 unknown 命令。 2010-11--02 版权所所有，侵权必究究第57页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 unknown命令不是TC CL的核心的的一部分，它它是由TCL脚本实现的，脚，可以在TC CL安装目录录的lib 子目录下下的init.tcl文件中找到其其定义。 unkn nown命令具有以下功能能： 1。如如果命令是一个在TCL的某个库文文件(这里的库库文件指的是TCL目录的lib子目录录下的 TCL脚本本文件)中定义义的过程，则加载该库库并重新执行行命令，这这叫做“auto-loading”（自动加载），关关于它将在下下一节描述。 2。如如果存在一个个程序的名名字与未知命命令一致，则则调用exec命令来调用该命该程序，这这项特性叫做“auto-exec”（自动执行）。例如你输输入“dir”作为一个命令令，unknown会执行“execc dir” 当前目录的内内容，如果这这里的命令令没有特别指指明需要输入入输出重定向，则自动动执行来列出当功能会使使用当前Tcll应用所拥有有的标准输入入输出流，以及标准错错误流，这不不同于直接接调用 exec命令令，但是提供供了在Tcl应用用中直接执行行其他应用用程序的方法法。 3。如如果命令是一组特殊字字符，将会产产生一个新新的调用，这这个调用的内内容是历史史上已经执行过过的命令。例例如，如果果命令时“!!”则则上一条刚刚执行过的命命令会再执行行一遍。下下一章将详细讲讲述该功能。。 4。若若命令是已知命令的唯唯一缩写，则则调用对应的的全名称的正确命令。在TCL中允允许你使用命令令名的缩写，只要缩写唯一即可。如果果你不喜欢unknown u 的缺缺省的行为，你也可以自己写一个个新版本的unnknown或者者对库中已有unnknown的命命令进行扩展展以增加某项项功能。如果你不想对对未知命令做做任何处理理，也可以删除除unknown，这样当调用用到未知命令令的时候就会会产生错误。 1.11.8 自动加载载在 unnknown过程中中一项非常常有用的功能能就是自动加载，自动动加载功能允允许你编写一组 Tcl过程放放到一个脚本文件中，然后把该文文件放到库目录之下，当程序调用用这些过程程的时候，第一一次调用时由由于命令还还不存在就会会进入unknow wn命令，而而unknown则会会找到在哪哪个库文件中包包含了这个过过程的定义，接着会加加载它，再去去重新执行命命令，而到下下次使用刚刚才调用过的命命令的时候，由于它已经经存在了，从而会正常常的执行命令令，自动加载载机制也就就不会被再次启启动。 2010-11--02 版权所所有，侵权必究究第58页，共共76页 TCL培训教程(全) 程绝密请输入文档档编号自动动加载提供了了两个好处，，首先，你可以把有用用的过程建立立为过程库，，而你无需需精确知道过程程的定义到底底在哪个源文文件中，自自动加载机制制会自动替你你寻找，第二二个好处在在于自动加载是是非常有效率率的，如果没有自动加加载机制你将将不得不在TCL T 应用的开开头使用souurce命令来加载载所有可能用用到的库文文件，而应用用自动加载机制，应用用启动时无需需加载任何何库文件，而且且有些用不到到的库文件永永远都不会会被加载，既既缩短了启动动时间又节省省了内存。使用用自动加载只只需简单的按按下面三步来来做：第一一，在一个目目录下创建一一组脚本文文件作为库，一般这些文文件都以".tccl"结尾。每每个文件可以包包含任意数量量的过程定义义。建议尽尽量减少各脚脚本文件之间间的关联，让让相互关联联的过程位于同同一个文件中中。为了能能够让自动加加载功能正确确运行，prooc命令定义一一定要顶到到最左边，并且且与函数名用用空格分开，过程名保保持与proc在同一行上。第二二步，为自动加载建立立索引。启启动 Tcl 应用比如 tclsh ，调用命令 auto_mkindeex dir pattern , 第一个参数第数是目录名，第二个参数数是一个模模式。auto_m mkindex在目录录dir中扫描描文件名和模式式pattern匹配配的文件，并并建立索引以指出哪些些过程定义在在哪些文件中中，并把索索引保存到目录录 dir 下一个叫 tclindex 的文件中。如的如果修改了文文件或者增增减过程，需需要重新生生成索引。第三三步是在应用用中设置变量auto_path，把存放了希望使用到到的库所在的的目录赋给给它。 auto_path变量包含了变了一个目录的的列表，当自自动加载被启启动的时候候，会搜索auuto_path中所所指的目录，检检查各目录下下的tclindex文件来确认文认过程被定义义在哪个文件件中。如果一一个函数被被定义在几个库库中，则自动动加载使用在在auto_path中靠前的那个中个库。例如如，若一个应应用使用目录录/usr/local/tccl/lib/shapes下的库，则在下在启动描述中中应增加： set auto_path [linsert [ $auto__path 0 /usr/loocal/tcl/lib/shappes] 这将将把/usr/local//tcl/lib/shapes作为起始搜作搜索库的路径径，同时保持所有的Tccl/Tk库不变变，但是在 /usr//local/tcl/lib/shhapes中定义义的过程具有有更高的优先级，一旦旦一个含有索索引的目录录加到了auto_paath中，里面面所有的过程程都可以通过过自动加载使使用了。 2 历史记录录 2010-11--02 版权所所有，侵权必究究第59页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号这部部分内容主要要描述TCL的历史机制的，涉及到对对以前执行过过的命令的应应用。历史史机制在一个列列表中保留了了最近执行过过的命令，使你不必重重新敲入命令令，还可以对对以前的命命令进行修改以以创建新的命命令而不必重重新输入新新的命令，特特别是在命令令较长时更加加方便。 historry命令的格式式为： histoory ?option? ?arg arg ...? 其中中option 可为add, change, clear, event, info, keep, neextid, 或者reedo。老版本本中有substituute 和 words，现现在的版本（8.0以后）中被删掉了了，增添了clear c 。下面一一一介绍： histoory 和historry info相同，显示以前前执行过的命命令和序号，如果执行过过的命名个个数超过了历史史记录列表允允许的最大的数量，则则只能按最大大数量显示最最近执行过的命令。注意意： history 命令本身在命历史记录列列表中也占了一条，如如：原来只有有一条命令令 set a 123，现在在输入historry，则：％hisstory 1 set a 123 2 history 显示示出两条历史史记录。 histoory add com mmand ?exeec? 在历史史记录列表中中加一条命令，如果有有exec选项，则执行该命令令，并返回结结果；如果果没指定execc选项，则返返回空字符串串作为结果。。其中添加加的新命令要用用双引号或花花括号括上。如： %history add "set b 100" exec 100 %history 1 hiistory add "sett b 100" exec 2 sett b 100 3 hisstory histoory change neewValue ?evennt? 用newValue n 替代代序号为evennt的命令，同时历史记记录中的命令被被改写。如没没指定event则替换当前则前命令。如： %history 2010-11--02 所有，侵权必究究版权所第60页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 1 set a 123 2 set b 23 3 history %history change "sset a 100" 1 %history //set a 123被set a 100替换了。替 s a 100 1 set 2 set s b 23 3 history 4 history "set a 100" 1 5 history %history change "sset c 1" %history 1 set a 100 2 set b 23 3 history 4 history "set a 100" 1 5 history 6 set c 1 //这里historry change "sett c 1"被set c 1替换了 7 history histoory clear 清除历史记录清录列表的内内容，但记录录列表允许的的最大记录数数这一属性性仍然保留。例例如：如果用用history keepp 50把最大记记录数改变变为50，historry clear后记录录内容空了，但最大记录录数仍为50。 histoory event ?eevent? 其 event为历其中历史事件的序序号，返回该该序号的命令令行，如果果没指定event则返回上一条则条命令行。如如： % hisstory 1 seet a 123 2 seet b 23 3 history %history event 1 set a 123 2010-11--02 所有，侵权必究究版权所第61页，共共76页 TCL培训教程(全) 程绝密请输入文档档编号 %history event histtory event 1 histoory info ?co ount? 没有有count参数时时和history命令一样，有命有count参数时返回最近时近执行的count个命令。个 histoory keep ?cou unt? 把历史记录列表表允许的最大大数量设置为为count。系统统最初的最最大记录为20。 histoory nextid 返回下一条条将要添加到到历史记录录列表中的命命令的序号。例： %history seet a 123 2 set b 23 3 history %history nextid 5 //因为history nextidd的序号为4。 histoory redo ?even nt? 重新执执行记录列表表中序号为为event的命令令。event缺省省为-1。快捷捷键操作 !! 同命令 hisstory redo相同同。！event 同命令 hiistory redo eveent相同。这两两个快捷键操操作对应上一一节unknownn命令的第3个功能。个 3 TCL和C C\C++ 在阅阅读以下章节节之前，假定你已经安安装了TCL8.11或更高版本本，同时有一一个C或C＋＋的集成开发发环境。注意意安装TCL时一定要选择时择定制安装装，把头文件件和库文件都都安装上。 TCL解释器是由解由一个C库实实现的，在某某种意义上TCL T 语言可以以看作是一一个C库。我我们可以调用 TCL T 提供的库库函数来生成 TCL 解释释器、求一个个 TCL 脚本的的值或扩展 TCL 固有命令。 2010-11--02 版权所所有，侵权必究究第62页，共76页 TCL培训教程程(全) 绝密请输入文档档编号 TCL提供供了一组有用用的库函数来来供用户访问问TCL的变量量、分析命令参数、操操作TCL列表表、求 TCL表达达式的值等。 3.1 生成自己己的TCLSH 我们们可以轻易的的利用TCL库函数生成和库和Tclsh完全一一样的程序： #incluude "tcl.h" #incluude "stdio.h" #incluude "stdlib.h" int Tcl_AppInit(T T cl_Interp *interp); main(int argc, charr *argv[]) { Tcl_Main(argc, argv,Tcl_ApppInit); exxit(0); } int Tcl_AppInit(T T cl_Interp *interp) { Tcl_init(interp)); reeturn TCL_OK K; } 在工程中加入TCL L对应的库文文件，编译执行行。在其中交交互敲入命令，会发现和T Tclsh完全一样样。给出这个例子只是为了说说明利用TCL L提供的库函数数是可以多么么方便的生成成自己的应用。。但这个例子子目前还没有加入我们自己的的东西，下面面一步我们就将将加入我们自自己扩展的命令令。 3.2 扩展自己己的命令：方方法(一) TCL提提供了一整套套供用户扩展展自己的命令令的函数（请请参考文档《 TCL 库函数数介绍 ( 一 ) 》和《TCL库函数介绍库 (二)》〕。下面面介绍怎样扩扩展自己的TCL命令。 TCL允允许用户扩展展命令，TCL解解释器将把扩扩展命令和固有命令同等对对待。TCL的的扩展命令要求求用C 或C＋＋实实现。扩展一一个TCL命令大大致可以分为为两步：编写扩扩展命令对应应的C/C++过程程，注册命令令。 3.22.1 编写扩展展命令对应的的C/C++过程程 TCL要要求所有的T TCL扩展命令令对应的C/C+ ++过程具有同同样的形式。在tcl.h文件件中对TCL命令令过程 Tcl_CmdProc的定义是这样的: 2010-11--02 版权所所有，侵权必究究第63页，共共76页 TCL培训教程程(全) typedef int 绝密请输入文档档编号 Tcl_CmdProc T (ClientData clientdata,Tcl_Interrp* interp,int argc,cchar* argv[]); 个参数clientdaata暂时可以不不予理会，在在13.2.2将会介介绍。这个函数中第一个一个TCL解释器器，TCL解释释器是一个复复杂的结构，不不过让用户可可见的部分比比较简 interpp参数指向一单，TCL中中的定义如下下： Typeedef struct Tcl_ _Interp { char * result; Tcl_ffreeProc * freeeProc; int errorLine; }Tcl__Interp; argc和和argv与我们们编写C语言程程序时main函数的两个参数数的含义基本本一样，argc代代表命令的参参数个数（包括命令名自身〕，argv是一个个字符串数组组，记录各个参数的字符形形式。值为整型，将将在13.2.3节单单独讲解。命令过程的返回值单的扩展例子子。假如我们想想扩展一个命命令 add ，形式式为add int1 int2，实现两两个整下面给出一个简单以这样给出其其实现：数相加。那么我们可以 A ntData clientdaata,Tcl_Interp** interp,int arggc,char * argvv[]) int AddCmd(Clien { iff(argc!=3) { interp-->result="Useaage Error! shoould be : add int1 i int2"; return TCL_ERROR R; } innt i,j; iff(TCL_OK!=T Tcl_GetInt(inteerp,argv[1],&i)) { sprintff(interp->resullt,"Expect inteeger but got %s",argv[1]); % return TCL_ERROR R; } Tcl_GetInt(inteerp,argv[2],&jj)) iff(TCL_OK!=T { sprintff(interp->resullt,"Expect inteeger but got %s",argv[2]); % return TCL_ERROR R; } 2010-11--02 所有，侵权必究究版权所第64页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 i= =i+j; spprintf(interp-> >result,"%d",i)); reeturn TCL_OK K; } 其中中， Tcl_GetInnt 等函数可可以参考文档档《 TCL 库函数介绍 ( 一 ) 》和《 TCL T 库函数介绍 (二)》。 3.22.2 注册命令令 TCL提供了一个提个库函数Tcl__CreateComm mand 负责把每每一个使用C/C++语言编编写的上述述形式的TCL命令过程向命 TC CL解释器注注册,它的原型型为: Tccl_CreateComm mand (Tcl_IInterp* interrp, char* ClienntData clienttdata, c cmdName, Tcl_CmdProcc* cmdProc,, Tcl_CmdDeleteP Proc* deletePrroc) 第一一个参数是一一个解释器指指针。第二二个参数是你你想给自己的的TCL命令取取的名字。第三三个参数是一一个函数指针针,指向我们们自己用C/C+++语言编写的TCL命令过过程。一旦旦注册成功,T TCL解释器将将把命令过程cmdProc和命令名和 cmddName严格对对应起来,一旦你一在TCL中激活了命令中令名cmdNam me,TCL解释器器就会自动调调用命令过过程cmdProc.例如例 :TCL解释器解遇到命令令add,就会调调用AddCmd命令过程命 . 第四四个参数是用用来传递用户户自己定义义的数据对象象的，TCL记录这个参数记数指向的对象象,并把它传递递给命令过程程cmdProc的第一个参数的数。利用这个参数我们们可以方便的的实现在多个命令过程中中对同一个数数据对象进行行操作。 ClienntData类型在在TCL的定义义为 typedef vooid *ClientDaata; 它可以指指向任何类型型。最后后一个参数是是一个函数指针，它指指向一个回调调函数,当我我们从解释器器 interp中删除命令 cmdNaame 时，函数 deleteProoc 就会被激活， deletteProc 必须有同一的形式 , 在 TC CL 中 Tcl_CmdD DeleteProc的定定义为： typeddef void (Tcl_CmdDeleteProc) (ClientDaata clientData); 我们们可以利用这这个回调函数中释放 cllientData 占用用的内存。在在较为复杂的 TCL 扩展中，我们将不不可避免的要要用到Tcl_C CreateCommannd的最后两个个参数。对于于我们上面编编写的AddCm md过程我们们可以这样注注册： 2010-11--02 版权所所有，侵权必究究第65页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 Tcl_C CreateCommaand(interp,"add",AddCmd,N NULL,NULL))；把这这个语句加到 13.1 节所举例子的 Tcl_AppInit T 函函数的 Returnn TCL_OK 语句之前，语再把 AddCmd函数的原型和函和实现加入入那个例子，编译执行。就可以交互互执行了：％addd 2 3 5 %addd a 2 Expeect integer but got 'a' 这样样，就在TCL L中扩展了一一个命令add，TCL解释器器遇到add命令时，就会命会把add命令令及其后面的参参数传递给对对应的命令过过程AddCmdd处理。 3.22.3 命令返回回值和命令对对应的过程的返回值 TCL命命令的返回值值总是一个字字符串，一个命命令的返回值值是由它对应的C/C++过程程决定的。从13.2.2 节所举的的例子我们也可可以看出来， TCL命令的的返回值是由对应的C/C++ +过程中interrp->result的值值决定的。在AdddCmd的例子子中，如果我们们把 Sprinntf(interp->ressult,"%d",i); 修改为 o %s and %s % is ：%d",aargv[1],argv[2]],i); Sprinntf(interp->ressult,"the sum of 重新编译执行，那那么 %Addd 2 3 the suum of 2 and 3 is ：5 需要注意的一点是是，interp->reesult的预分配配空间只有2000个字节，如果果命令的结果果的长度超过2200个数Tcl_SetResuult或Tcl_AppeendResult来管管理命令结果。字节，那么请使用函数们已经看到，一一个命令对应应的C/C++过程程的返回值是是一个整型值。TCL中命令令对应在13.2.1节中我们过程允许的返返回值是 TCL L_ERROR 、 TCL_OK K 、 TCL_B BREAK 、TC CL_CONTIN NUE和的C/C++过 TCL_RET TURN，这些返返回值是TCL L为了方便实现控制流和对对脚本文件的的求值进行控制制而引入的。通过设置命令令过程的返回值值，我们可以以控制TCL脚脚本的执行过过程，也可以实实现自己的控控制流。TCL L中的 while命令令就是这样实现现的。 int WhileCmd(Clie W entData clientD Data, Tcl_Inteerp *interp, innt argc, char *aargv[]) { innt bool; 2010-11--02 版权所所有，侵权必究究第66页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 innt code; iff (argc != 3) { interp-->result = "wroong # args"; return TCL_ERROR R; } w while (1) { ult(interp); Tcl_ResetResu oolean(interp, argv[1], &boool)!= TCL_OK K) iff (Tcl_ExprBo { return TCL__ERROR; } iff (bool == 0) { return TCL_OK; } coode = Tcl_Evaal(interp, argvv[2]); iff (code == TCL L_CONTINU UE) { continu ue; } = TCL_BREA AK) ellse if (code == { return TCL_OK; } ellse if (code != TCL_OK) { return code; } } TCL扩展命令令时，也应该注注意设置TCL L命令过程的的返回值以控制制TCL命令的的执行我们在自己设计T 当某一个命令令有错时，整个个脚本还能继继续往下执行行，那么我们可可以把那个命命令过过程。如果我们希望当 L_OK。例如，在扩展了addd命令之后，我们可以编写如下脚本：程的返回值总设为TCL 2010-11--02 所有，侵权必究究版权所第67页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 %evaal set a 2; ad dd a 3 ;set b 4 Expeect integer but got a %set b Can'tt read "b":no such s varible 这说明，由于在执执行“add a 3”时出错，导致“set b 4””根本没有被执执行。现在，我们在AddC Cmd过全部改为TCL__OK,再编译执执行：程中，所有的返回值全 dd a 3 ;set b 4 %evaal set a 2; ad 4 %set b 4 执行了。这说明set b 4被执 TCL 解释器在执行脚本时，如果遇到脚本中某一个命令对应的命令过程的返回值为 ROR，那么解解释器马上退出，不再对后后面的脚本求求值。由此可见，利用命令令对应的过程程的返 TCL_ERR 回值，我我们可以控制制脚本的执行行过程。根据据实践，一般般的原则是，如果有语法法错误，应该该返回 TCL_ERR ROR，别的情情况下可以根据据需要决定。 3.3 扩展自己己的命令：方方法(二) 从上面的介绍来看看，TCL从外外部应用到内部部实现都是基基于字符串的的，这样在涉及及到类型转换换时，及其字符串表表示之间来回转转换，效率比比较低，加上上TCL是解释执执行的，导致致在利需要在各种数据类型及用TCL作较较为大型的应应用程序时执执行速度不够理理想，所以在在TCL8.0以后后的版本中，T TCL在内部实实现中引入了一一个新的数据据结构Tcl_O Obj，代替了原来单纯的的字符串表示示。利用这个个结构，可可以一方面保持持TCL库函数数的前向兼容容，另一方面面可以提高高TCL解释执行的速度。由于于这一结构的的引入，TCL L也提供了另另外一套扩扩展TCL命令的函数，与与13.2介绍的的方法稍有不同同。下面面先对Tcl_Obbj结构作一介介绍。结构 3.33.1 Tcl_Obj结在TC CL中，Tcl_O Obj结构定义义如下： typeddef struct Tcl_ _Obj { int refC Count; char *b bytes; int leng gth; 2010-11--02 版权所所有，侵权必究究第68页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 Tcl_Ob bjType *typeP Ptr; union { long longVaalue; double doubbleValue; VOID *otheerValuePtr; struct { OID *ptr1; VO VO OID *ptr2; } tw woPtrValue; } internalReep; } Tcll_Obj; 在TC CL的新的实现现中，所有的对象(变量的值值，命令参数数，命令结果等等)都以Tcll_Obj对象保存存： 1.分量量bytes和leng gth实际代表了了对象的字符符串表示，byytes必须以nulll结尾。如果bytes为null，表示对象的字符串表示无效效。向一个Tcl_ObbjType，其中中记录了对象的的内部类型的的名称、释放对对象的内部表表示的 2.typePtr 分量指向果这个分量为为null，那么表表示internalRepp分量无效。函数的指针等等。如果当typePtr 分量量不为空时，iinternalRep用用来保存对象的的内部表示，这可以是一个个整数，也可可以是 3。当一个双精度浮点数，或或者一个指针针，或者两个指指针。分量refCount记记录对象被引引用的次数，由此决定什什么时候可以安安全的释放这这个对象占用用的空 4。分间。对扩展TCL命令的的用户来说，怎样维护refC Count是很关键键的。表示，TCL可可以当需要字符符串形式时，就输出Tcl_O Obj的字符串形形式，需要对对象的采用了这种内部表际类型的值。下面以一系列列命令调用来来说明TCL是怎怎么利用Tcl__Obj结构的：实际类型时就输出实际 set x 123 这个命令赋予变量量x一个无类型型的Tcl_Obj对对象，其bytess分量包含"1223"，而lengthh分量的值为33。这有效，而typeP Ptr分量为空，因而内部表表示internalRepp无效。时对象的字符串表示有 puts $x 有效的，所以以直接取得x的的字符串表示。。这时，因为x的字符串表示是有 incr x 命令对应的过过程调用 Tcl_G GetIntFromObbj函数从x对应应的对象表示示中取得一个整整数。这个函函数首 incr命先检查x的的对应的Tcl_ _Obj对象是否否已经是一个整整数对象。因因为现在typeP Ptr为空，所以以并非一个整整数对象，因此此它需要转换这这个对象：从从字符串表示示中可以得到到internalRep. longValue的值为123，同同时把 typePtr指向一个整数的的Tcl_ObjTyppe结构。这时时，两种表示方方法都成为有有效的了。接接着incr命令把把对象 2010-11--02 所有，侵权必究究版权所第69页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号的internallRep. longVallue值加1，同同时调用Tcl_InnvalidateStrinngRep来使得xx的字符串表示示无效。因为为此时字符串表示还是123，而实际应该为为124。 puts $x 这时又需要x的字字符串表示，而而这时字符串串表示已经无无效，所以需要要转换internaalRep. longVaalue来获取x的字字符串表示。这个命令调用用后，两种表表示又都成为有有效的了。从上面可以看出，TCL之所以采用Tcl_Obj来表示对象，就是为了尽尽量减少类型的的转换次数。但这一定的额外工工作量。所以如果不是对速速度有特殊的的要求的话。我我们扩展TCL L命令也给用户扩展带来了一绍的方法，而不不必使用下面面介绍的方法。完全可以使用13.2介绍 3.33.2 编写扩展展命令对应的的C/C++过程程第二种TCL扩展命命令对应的C//C++过程的形形式和13.2介绍的稍有不同同。在tcl.h文文件中的定义义是这样的: typedef int Tcll_ObjCmdProoc( ClientData clientData, Tcl_Interp * *interp, i int objc, Tcl_Obj* const objv[] o ); 2中介绍的完全全一样。前两个参数和13.2 代表Tcl_Obj对对象的个数，因为命令的每每个参数(包含含命令名本身身)都用一个对对象表示，所以以objc objc代事实上相当于Argc。个对象数组，指向各个参数数的对象表示示。第四个参数是一个值和13.2完全一一样。命令过程的返回值中给出的扩展例例子用第二种种形式改写一下：下面我们把13.2中 A ntData clientdaata,Tcl_Interp** interp,int obbjc,Tcl_Obj * const c objv[]) int AddCmd(Clien { iff(objc!=3) { interp-->result="Useaage Error!"; return TCL_ERROR R; } innt i,j,l1,l2; iff(TCL_OK!=T Tcl_GetIntFrom mObj(interp,oobjv[1],&i)) { sprintff(interp->resullt,"Expect inteeger but got %s",Tcl_GetStr % ringFromObj(oobjv[1],&l1));; return TCL_ERROR R; } 2010-11--02 版权所所有，侵权必究究第70页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 iff(TCL_OK!=T Tcl_GetIntFrom mObj(interp,oobjv[2],&j)) { sprintff(interp->resullt,"Expect inteeger but got %s",Tcl_GetStr % ringFromObj(oobjv[2],&l2));; return TCL_ERROR R; } =i+j; i= spprintf(interp-> >result,"%d",i)); reeturn TCL_OK K; } 除了Tcl_GetInnt换成了Tcl__GetIntFromO Obj之外，基本本没有多大的的不同。我们可以看到，除 3.33.3 注册命令令相应应的，第二种种扩展方法也也提供了自己命令注册册函数,它的原原型为: void Tcl_CreateObjCommandd ( Tcl_Interpp * interp, Tcl_ObjCm mdProc * chhar * cmdNam me, cm mdProc, ClientData clientData, Tcl_CmdDelleteProc * deleeteProc) 事实实上这和13.22中介绍的Tcll_CreateComm mand 命令差不多，唯一一的区别在于于第三个参参数，即命令过过程必须是第第二种形式的命令过程程。如果果我们使用了了第二种方法法扩展了命令过程，那那么必须使用用第二种方法法注册命令令，否则会导致致错误。除了了13.3.2和13.33.3中讲到的的不同外，两两种扩展方法没有太大大的不同。不不过如果我我们在扩展过程程中自己构造造了 Tcl_Objj对象的话，一定要注意维护其被被引用的次数数。另外也要注意，象133.3.1中的例子讲到的inccr命令过程那那样，如果果需要的话，必须让对象象的内部表表示的一种失效效。 3.4 利用clie entData参数数和deletePrroc参数在使使用C ＋＋扩扩展 TCL命令令时，我们不不可避免的要用到类和和自定义类型型，这时有有这种需求：几几个或一组命命令需要对同一个对象象进行操作。这时我们除除了利用全局局变量外，还有其他办法法吗？有！那那就是利用clientData c 参数数。前面的例子中，我我们已经看到到，每一个命令令函数的第一一个参数是CliientData类型，，而用来注册册自定个ClientData类类型的参数。这个义命令的库函数Tcl_CreateCommannd 和Tcl_CreaateObjCommaand，也有一个 2010-11--02 版权所所有，侵权必究究第71页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 ClientDataa 类型参数指指向的就是自定定义命令所要要处理的对象象，而且ClienttData 被定义义为void *类型型，可以指向任何类型的对象象。如果用户想在命令中使使用自己定义义的数据对象，，就可以利用用ClientData。 Tcl_C CreateCommaand和Tcl_CreeateObjComm mand函数还有有一个参数是是（Tcl_CmdD DeleteProc * 〕类型，这个参数指向一个个回叫(callbaack)函数，当删删除某一个命命令或程序退退出时，TCL会会调用对应的的回叫的数据对象进进行善后处理。Tcl_CmdDeeleteProc 的定定义如下：函数来对该命令处理的 ARGS_((ClienttData clientDaata)) typeddef void (Tcl_CmdDeleteProc) _ANSI_A 可以看出，Tcl_C CmdDeleteProc * 类型是指指向一个带有有一个ClientDaata类型参数，无返回值的的函数计一个这样的的回调函数来释释放自定义命命令所处理的的数据类型的对对象申请的存存储空的指针，我们可以设计间。下面面将以一个简简单的类(claass)来说明在在扩展TCL命令时怎么使命使用自己定义义的数据类型型。 #incluude "Tcl.h" class Sample { privaate: innt x; publiic: Saample(){ x=0;;} Saample(Samplee& sa){ x=sa.xx;} vooid Set(int _x)); innt Get(); }; int Saample::Get() { reeturn x; } void Sample::Set(int _x) { =_x; x= } int Tccl_InitApp(Tccl_Interp* inteerp); int MyGetCmd(Cli M ientData clienntdata,Tcl_Inteerp* interp,int argc,char * argv[]); a int MySetCmd(Cli M entData clienttdata,Tcl_Interp* interp,int argc,char * arrgv[]); void DeleteProc(ClientData clienntdata); 2010-11--02 所有，侵权必究究版权所第72页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 void main(int argc,,char* argv[]) { Tcl_Main(argc,argv,Tcl_InitApp); reeturn; } int Tccl_InitApp(Tccl_Interp* inteerp) { Tcl_IInit(interp); Sampple* pSam=neew Sample; Tcl_C CreateCommaand(interp, "m myget", MyG GetCmd, (C ClientData)pS Sam, (T Tcl_CmdDeleeteProc*) DeleteProc); CreateCommaand(interp, Tcl_C " "myset", M MySetCmd, (ClientDataa)pSam, (T Tcl_CmdDeletteProc* )DeletteProc); K; reeturn TCL_OK } M ientData clienntdata,Tcl_Inteerp* interp,int argc,char * argv[]) a int MyGetCmd(Cli { iff(argc!=1) { interp-->result="Usagge error!"; return TCL_ERROR R; } =(Sample* )cllientdata; Saample* pSam= iff(!pSam) { return TCL_ERROR R; } >result,"%d",ppSam->Get()); spprintf(interp-> reeturn TCL_OK K; } int MySetCmd(Cli M entData clienttdata,Tcl_Interp* interp,int argc,char * arrgv[]) { iff(argc!=2) { 2010-11--02 所有，侵权必究究版权所第73页，共76页 TCL培训教程程(全) 绝密请输入文档档编号 interp-->result="Usagge error!"; return TCL_ERROR R; } =(Sample* )cllientdata; Saample* pSam= iff(!pSam) { return TCL_ERROR R; } innt i; iff(TCL_OK!=T Tcl_GetInt(inteerp,argv[1],&i)) { sprintff(interp->resullt,"Expect inteeger but got %s",argv[1]); % return TCL_ERROR R; } Sam->Set(i); pS spprintf(interp-> >result,"%d",i)); reeturn TCL_OK K; } void DeleteProc(ClientData clienntdata) { innt static i=0; iff(i!=0) return; deelete (char*)cllientdata; i= =1; } 编译译运行这个例例子，交替敲入命令 myget m 和 myset 可以反映出出对数据对象象 pSam的操操作导致的变化化。函数DeeleteProc当我我们删除mygget或myset命令时会被激命激活，这时与与这两个命命令相关的对象象*pSam的空空间被释放.调试运行这个调个程序，在在控制台中敲敲入 renam me myget {} 这个个命令从解释释器中删除myget m 命令，我们会发现现DeleteProc函数会被自动函动调用。敲入入 renam me myset {} DeletteProc函数也也会被自动调调用。 2010-11--02 所有，侵权必究究版权所第74页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号事实实上这个简单单的利用类进进行扩展的例子揭示了了更多的含义义：首先，说说明我们可可以在以前利用用C++编写的的代码的基础础上进行TC CL扩展，提提高代码的可可重用性，我我们编写的的代理的TCL扩展这样作的扩的；另外，我我们不但可以利用TCL对C函数作单单元测试，也可以利用用TCL 对类的成成员函数作单单元测试。 3.5 在C/C++ +应用程序中中嵌入TCL 在 133.1 中，我们们扩展 TCL 的方法是利用的用 Tcl_Main 函数直接生成函成一个独立立的 TCL 交互互式程序。其实实，我们还有有更好的使用用TCL的方法法：在应用程序中嵌入入TCL。前面面已经说过，TCL在某种种意义上可以以被认为是一一个C函数/过程库。这这决定了TCL L可以和C/C++应用程序无应无缝集成-----我们可以轻我轻易的把TCL嵌入到我们们的一个C/C+++应用程序序中，这也是TCL T 被广泛应应用的一个重重要原因。TCL的可嵌嵌入性使得我我们可以为每每一个应用程序提供一个个支持变量、、过程、控制制流等编程程要素并包括括扩展命令和和固有命令在在内的功能能完备的TCL扩展语言。扩下面面介绍在一个个C/C++程序序中嵌入TCL的方法. 假设设我们已经用用VC6生成了了一个应用程程序,并且加加入一个菜单单项TCL,OnT Tcl是菜单项项TCL 的消息响响应函数: void CMyExView:::OnTcl() { Tcl_Interp* interp=Tcl_CreaateInterp(); iff(Tcl_InitApp((interp)) { AfxMeessageBox("TCL initialize Error!"); E return; } C CFileDialog dlg g(TRUE,NUL LL,NULL,OFN N_HIDEREADONLY|OFN N_FILEMUST TEXIST, "Tcl Files(**.tcl)|*.tcl|All Files(*.*)|*.*| F |"); DoModal()) iff(IDOK!=dlg.D { return; } C CString strFileP Path=dlg.GetP PathName(); 2010-11--02 版权所所有，侵权必究究第75页，共共76页 TCL培训教程程(全) 绝密请输入文档档编号 //eevaluate the TCL T descriptioon file iff(TCL_OK!=T Tcl_EvalFile(interp,(char*)((const char*)sttrFilePath)) { AfxMeessageBox("There are errorss in your Tcl File"); F Tcl_DeeleteInterp(intterp); return; } Tcl_DeleteInterrp(interp); } 我们们可以把前面面的扩展命令 add 的实现现部分集成到这个程序序中，那么我我们可以编写一个这样的的脚本: seet a 2 seet b 3 addd $a $b 存成成一个文件。点击菜单项TCL，就可以打开这这个个编辑好好的TCL文件件并执行。遗憾的是我们们不能看到执执行结果。不过我们可可以通过单步步调试来跟跟踪命令的执执行过程.在实际在应用中，如果想看到到命令执行结果，可以以在我们的扩扩展命令过程程中加入对命命令执行结结果输出到某一一个窗口的语语句。 4 总结这篇文章是《TCL L的使用》和《TCL培训教教程》的补充和修订，并加加入了很多新新内容。其中第第9、 10、11、12章是新加加的内容，新加加的各个章节节是北研测试部部TCL兴趣小小组各个成员共共同努力的结结果：章完成，第10章杜祥宇完成，章，第11章由邓邓沈鸿完成，最后由我对各各个章节进行行了整第9、12章由付剑仲完理和修改，统一组稿。了TCL的各个个方面，特别对对使用C\C++ +语言扩展TC CL命令作了详详尽的描述，这是本文基本上介绍了找到的内容。参照本文的例子，用户完完全可以写出出自己的TCL扩展命令。希扩希望这所有的参考书上难以找试部使用TCL起一些推动作起作用。篇文章能对推广在测试本上来说还是是要上机实习习，希望测试试部所有员工工大家都能安安装上学习一门计算机语言，从根本 TCL，加以以实习，在应应用的基础上上才能进一步提提高。如果需需要一些本文文中没有的内容容，可以查阅阅TCL 自带的帮助。 2010-11--02 版权所所有，侵权必究究第76页，共共76页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 目录 1初始化函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 2解释器的生成和删除及TCL脚本的求值函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 3命令生成和删除函数及结果处理函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4分析函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5总结 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 6访问TCL变量的函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7Hash表操作函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 8字符串操作函数 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 9TCL库函数的最新情况 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 第 1 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- TCL库函数介绍(一) 关键词：TCL 摘要：本文旨在推广TCL的使用，通过分类介绍TCL的库函数的用法，让用户了解怎样利用这些库函数去编写TCL扩展命令。为了让用户能方便地扩展TCL命令，TCL为用户提供了大量的库函数供用户使用，满足用户各方面的需要。用户可以在用C\C++语言编写扩展的TCL命令过程或函数时，调用这些库函数。要真正理解这些库函数的用法，最佳途径是参照一些例子，并实际使用。在我的一篇文档《TCL的使用》中有一些这些函数的使用的例子。下面分类对TCL的库函数进行介绍。 1 初始化函数这组函数用于用户初始化应用。 1.Tcl_Init函数原型： int Tcl_Init (Tcl_Interp *interp) 参数interp是一个指向TCL解释器的指针。Tcl_Init函数只作一些简单的初始化工作，没多大的用处。不过，用户一般需要提供自己的初始化函数，原型与Tcl_Init一样，在这个函数中，要作应用的初始化工作，如注册自己的TCL扩展命令，生成自己需要的数据对象等。这个函数必须在生成 TCL解释器后才能调用。生成TCL解释器可以调用Tcl_CreateInterp函数，另外Tcl_Main函数中也会自动生成TCL解释器。 2.Tcl_Main函数原型：void Tcl_Main (int argc, char **argv,Tcl_AppInitProc *appInitProc) 如果用到这个函数的话，应该在你的C\C++程序的main函数中调用，它的前两个参数和main函数的两个参数一样，第三个参数是一个函数指针，指向一个初始化函数，其原型和Tcl_Init一样。如果程序没有任何命令行参数，Tcl_Main调用appInitProc初始化函数，并启动一个TCL的命令解释循环，建立一个交互环境，等待你输入TCL命令和脚本并解释执行。如果程序有命令行参数，那它先调用appInitProc函数作一些初始化工作，然后把第一个命令行参数作为TCL脚本文件名，并求值返回，其余参数不予理会。 2 解释器的生成和删除及TCL脚本的求值函数这组函数提供生成和删除TCL解释器及对TCL脚本进行求值的功能。每一个TCL应用，都必须拥有至少一个TCL解释器，事实上几乎所有的TCL库函数都有一个指向TCL解释器的指针的参数。每一个扩展的TCL命令都和特定的TCL解释器相关联，只有在对该命令进行了注册的TCL解释器中，这个命令才是有效的，才能被解释执行。 1.Tcl_CreateInterp函数原型：Tcl_Interp *Tcl_CreateInterp(void) 第 2 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 这个函数生成一个新的TCL解释器，并返回指向这个解释器的指针。 2.Tcl_DeleteInterp函数原型：void Tcl_DeleteInterp(Tcl_Interp *interp) 这个函数删除一个TCL解释器，并会触发用户定义的回调函数，作一些善后工作。 3. Tcl_Eval函数原型： int Tcl_Eval(Tcl_Interp *interp char *script) 这个函数在解释器 interp 中求脚本 script 的值并返回执行情况。结果和错误信息保存在 interp->result中。函数返回值表示执行情况，为以下五个值之一： TCL_OK ：表示执行成功 TCL_ERROR：表示执行过程中遇到了不可克服的错误 TCL_BREAK：表示break命令被激活 TCL_CONTINUE ：表示conitinue命令被激活 TCL_RETURN：表示return 命令被激活事实上所有int型的TCL库函数都以上述值为返回值，TCL_OK和TCL_ERROR最常用，后面三个只是当用户需要实现自己的控制流才会用到。下面介绍的库函数就不再介绍返回值。 4. Tcl_EvalFile 函数原型：int Tcl_EvalFile(Tcl_Interp *interp, char *fileName) 这个函数在解释器interp中求脚本文件fileName的值并返回执行情况。结果和错误信息保存在 interp->result中。 5. Tcl_GlobalEval函数原型：int Tcl_GlobalEval(Tcl_Interp *interp, char *script) 这个函数在解释器interp中在全局层次上求脚本script的值并返回执行情况。结果和错误信息保存在interp->result中。 6. Tcl_VarEval函数原型：int Tcl_VarEval(Tcl_Interp *interp, char *string, char *string,... (char *) NULL) 这个函数具有可变个数参数，必须以NULL作为最后一个参数，标记参数结束，它把所有的字符串参数合并成一个，在解释器interp中求它的值并返回执行情况。结果和错误信息保存在 interp->result中。 3 命令生成和删除函数及结果处理函数这组函数用于生成和注册用户自己定义的TCL扩展命令及管理TCL命令的结果。用户只有自己用C\C++语言编写了定义TCL命令的函数或过程，并注册，才能被解释器所识别和使用。这里还应该区分两个概念：TCL命令结果和定义命令的C\C++函数或过程的返回值。命令结果是执行TCL命令后，TCL解释器返回的命令执行结果，形式为字符串；而定义命令的C\C++函数或过程的返回值第 3 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 指的是我们编写的用来定义TCL命令的C\C++函数或过程的返回值，这些返回值已经在Tcl_Eval函数的说明中介绍了。TCL命令的结果需要我们在定义TCL命令的C\C++函数或过程中给出，如果我们希望TCL命令执行后返回某个值，只要把这个值以字符串形式存入interp->result中，TCL解释器就会在执行这个命令后返回这个字符串形式的值。 1. Tcl_CreateCommand函数原型：void Tcl_CreateCommand(Tcl_Interp * interp, char * cmdName,Tcl_CmdProc * cmdProc, ClientData clientData,Tcl_CmdDeleteProc * deleteProc) 这个函数在解释器interp中生成一个命令，并把它注册到这个解释器。这样这个命令在这个解释器中就可以和TCL固有命令一样使用。函数的第一个参数指向TCL解释器，第二个参数是一个字符串，代表命令名，第三个参数是一个函数指针，指向你用C\C++写的定义该命令的函数或过程，第四个参数指向你希望传给你的函数或过程的数据对象，第四个参数也是一个函数指针，指向一个回调函数，当你删除这个命令时，解释器会自动激活这个过程。tcl.h中对Tcl_CmdProc的定义如下： typedef int Tcl_CmdProc(ClientData clientData, Tcl_Interp *interp, int argc,char *argv[]); 其中：typedef void * ClientData; 每一个用C\C++写的定义命令的函数或过程必须为上面的形式：第一个参数实际上是一个 void指针，可以指向任何数据类型，这里指向用户需要传给那些函数或过程的数据对象，第二个参数指向解释器，第三个参数代表这个命令的参数个数(包括命令名本身)，第四个参数是一个字符串数组，其中保存各个参数的字符串形式的值。返回值为整数，只能为 TCL_OK、TCL_ERROR 、 TCL_BREAK、TCL_CONTINUE 、TCL_RETURN其中之一，这在上面已经介绍过。 2. Tcl_DeleteCommand函数原型： int Tcl_DeleteCommand(Tcl_Interp *interp, char *cmdName) 这个函数从解释器中删除一个命令，同时激活该命令对应的回调函数。我们在利用C\C++编写TCL扩展命令过程时，一般可以通过把interp->result指向一个字符串或使用 sprintf 函数来设置命令的执行结果。但是interp->result的缺省大小只有200字节，如果命令结果太长就会出错。因此TCL提供了以下库函数来供用户管理命令结果： 3. Tcl_SetResult 函数原型：Tcl_SetResult(Tcl_Interp *interp, char *string,Tcl_FreeProc* freeProc) 这个函数的第一个参数是一个TCL解释器，第二个参数是一个将作为命令结果的字符串，第三个参数是一个函数指针，定义如下： typedef void (Tcl_FreeProc)(char *blockPtr) 第三个参数的值可以为： TCL_STATIC ：这表示string是静态的，Tcl_SetResult只简单的把它的指针存入interp->result TCL_VOLATITLE：表示string会改变，Tcl_SetResult会把它复制到interp->result，如果 string太长，会重新分配内存。第 4 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- TCL_DYNAMIC：表示string是用malloc分配的内存，并成为TCL的一个属性:Tcl_SetResult 将把interp->freeproc设置 free 以释放内存。一个Tcl_FreeProc类型的函数：表示string是动态分配的， TCL最终会调用这个函数来释放内存。 4. Tcl_AppendResult 函数原型：Tcl_AppendResult(Tcl_Interp *interp, char *string,char *string, ... (char *) NULL) 这个函数是具有可变个数参数的函数，必须以NULL作为最后一个参数，标记参数结束，它把所有的string参数按顺序添加到interp->result中。 5. Tcl_AppendElement 函数原型：Tcl_AppendElement(Tcl_Interp *interp, char *string) 使用这个函数时，命令结果应是一个链表，它把 string 参数作为链表的一个元素添加到 interp->result中。这个函数当需要生成一个链表时很有用。 6. Tcl_ResetResult 函数原型：Tcl_ResetResult(Tcl_Interp *interp) 这个函数把interp->result清空。 4 分析函数这组函数用于对命令的参数进行分析，是最常用到的库函数。前面已经介绍过，每一个定义 TCL命令的C\C++函数或过程都有参数argc和argv，TCL解释器在解释执行TCL命令时，会把命令的参数个数和参数的字符串形式传给定义这个命令的C\C++函数的argc和argv参数，并执行这些函数或过程。因为所有参数以字符串形式传递，所以我们需要对它们进行分析，从而会用到以下函数： 1.Tcl_GetInt函数原型：int Tcl_GetInt(Tcl_Interp *interp, char *string, int *intPtr) 这个函数把string作为一个整数分析，值存在*intPtr中。成功返回TCL_OK ，失败返回 TCL_ERROR，并把错误信息存在interp->result中。 2. Tcl_GetDouble函数原型：int Tcl_GetDouble(Tcl_Interp *interp, char *string, double *doublePtr) 这个函数把string作为一个浮点数分析，值存在*doublePtr中。成功返回TCL_OK ，失败返回 TCL_ERROR，并把错误信息存在interp->result中。 3. Tcl_GetBoolean函数原型：int Tcl_GetBoolean(Tcl_Interp *interp, char *string, int *intPtr) 第 5 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 这个函数把string作为一个BOOL值分析，并把0\1存在*intPtr中。成功返回TCL_OK ，失败返回TCL_ERROR，并把错误信息存在interp->result中。 4. Tcl_ExprString函数原型：int Tcl_ExprString(Tcl_Interp *interp, char *string) 这个函数把 string 作为一个表达式求值，成功返回 TCL_OK 并把值作为一个字符串存入 interp->result，失败返回TCL_ERROR，并把错误信息存在interp->result中 5. Tcl_ExprLong函数原型：int Tcl_ExprLong(Tcl_Interp *interp, char *string, long *longPtr) 这个函数同Tcl_ExprString，只是把结果作为一个长整型存入*longPtr，当值不能转换成一个整数时，发生错误。 6. Tcl_ExprDouble函数原型：int Tcl_ExprDouble(Tcl_Interp *interp, char *string,double *doublePtr) 这个函数同Tcl_ExprString，只是把结果作为一个浮点数存入*doublePtr，当值不能转换成一个浮点数时，发生错误。 7. Tcl_ExprBoolean函数原型：int Tcl_ExprBoolean(Tcl_Interp *interp, char *string, int * intPtr) 这个函数同Tcl_ExprString，只是把结果作为0\1存入*intPtr，当值不能转换成一个BOOL值时，发生错误。 8. Tcl_SplitList函数原型：int Tcl_SplitList(Tcl_Interp *interp, char *list, int *argcPtr,char ***argvPtr) 这个函数把list作为一个链表进行分析，并生成一个字符串数组，数组的元素是链表的元素。成功返回 TCL_OK ，链表元素的个数存入 *argcPtr ，并把 argvPtr 指向生成的数组。失败返回 TCL_ERROR，并把错误信息存在interp->result中。字符串数组的空间是动态分配的，必须由调用者释放。 9. Tcl_Merge函数原型：char *Tcl_Merge(int argc, char **argv) 这个函数是Tcl_SplitList的逆过程，返回指向生成的TCL链表的指针。链表的储存空间是动态分配的，调用者需要释放为链表分配的空间。 5 总结第 6 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 这篇文章介绍了TCL库中的常用到的几类函数，并结合自己的实际使用经验作了较为详细的说明，相信会给用户使用C\C++编写自己的TCL扩展命令带来一定的帮助。以后将陆续介绍所有的 TCL库函数，以推动TCL的应用。 TCL库函数介绍(二) 关键词：TCL 摘要：本文承接TCL库函数介绍(一) ，旨在推广TCL的使用，通过分类介绍TCL的库函数的用法，让用户了解怎样利用这些库函数去编写TCL扩展命令。 6 访问TCL变量的函数这组函数提供了在C代码中生成、修改、读取和删除TCL变量的手段。而且还提供了监视和限制变量访问的机制。这组函数是使用很频繁的一组函数。 1. Tcl_SetVar函数原型：char *Tcl_SetVar (Tcl_Interp *interp, char *varName, char *newValue, int flags) 这个函数把名为变量varName的变量的值设置为newValue，如果这个变量还不存在就声明这个变量。这个函数对变量操作的运行时刻上下文是这样的：如果这个操作发生在一个过程的运行中，那么这个操作针对的是这个过程的局部变量；否则这个操作针对的是一个全局变量。如果这个操作成功完成，函数返回指向这个变量的新值的指针。如果发生了错误，那么返回NULL。函数最后一个参数flags的取值可以为以下几个值中的一个或几个，中间以位操作符|连接： TCL_GLOBAL_ONLY：表示这个操作总是针对全局变量varName的。 TCL_LEAVE_ERR_MSG：表示如果操作失败，错误信息保存在interp->result中。 TCL_APPEND_VALUE：表示把newValue的值附加到以前的值后面，不覆盖原来的值。 TCL_LIST_ELEMENT：表示在设置或附加newValue的值之前，把它转换为链表的元素。注意：如果varName是带括号的形式,如：a(b)，那么这个函数将设置或生成一个数组元素，括号前的a将作为一个数组名，而括号中的b将作为数组元素的索引值。 2. Tcl_SetVar2函数原型：char *Tcl_SetVar2(Tcl_Interp *interp, char *name1,char *name2 , char *newValue, int flags) 这个函数功能与Tcl_SetVar函数类似。如果name2为NULL，那么它和Tcl_SetVar函数的功能完全一样。如果name2不为空，那么name1不能是带括号的形式（如： a(b)〕，这时name1作为数组名，而name2作为数组元素的索引。其余情况完全同Tcl_SetVar函数，事实上Tcl_SetVar函数的实现中只是简单的调用了Tcl_SetVar2函数。 3. Tcl_GetVar函数原型： char *Tcl_GetVar(Tcl_Interp *interp, char *varName,int flags) 这个函数用来获取变量varName的值，用法可以完全参考Tcl_SetVar，不过flags只支持 TCL_GLOBAL_ONLY和TCL_LEAVE_ERR_MSG，这应该是很自然的事情。 4. Tcl_GetVar2 函数原型： char *Tcl_GetVar2(Tcl_Interp *interp , char *name1 , char *name2 , int flags) 第 7 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 这个函数的用法与Tcl_GetVar的区别同Tcl_SetVar和Tcl_SetVar2的区别。 5. Tcl_UnsetVar函数原型：int Tcl_UnsetVar (Tcl_Interp *interp , char *varName , int flags) 这个函数从TCL解释器interp中删除变量varName，如果操作成功，返回TCL_OK，如果因为变量varName不存在或其他原因不能删除，那么返回TCL_ERROR。如果varName是一个数组名，没有给出索引，那么整个数组都被删除。 flags 只支持 TCL_GLOBAL_ONLY 和 TCL_LEAVE_ERR_MSG。 6. Tcl_UnsetVar2函数原型：int Tcl_UnsetVar2 (Tcl_Interp *interp , char *name1 , char* name2, int flags) 这个函数的用法与Tcl_UnsetVar的区别同Tcl_SetVar和Tcl_SetVar2的区别。 7. Tcl_TraceVar函数原型： int Tcl_TraceVar(Tcl_Interp *interp, char *varName, int flags, Tcl_VarTraceProc *proc, ClientData clientData) 这个函数用于对变量进行跟踪，当读、写或删除一个变量时就会自动激活一个C过程。跟踪可以用于很多目的：如debug、生成只读变量等。 varName是要跟踪的变量名，flags可以是以下几个值中的一个或几个，中间用位操作符 | 连接： TCL_TRACE_READS 、 TCL_TRACE_WRITES 、 TCL_TRACE_UNSETS和TCL_GLOBAL_ONLY，其含义一目了然。 clientData是回调函数proc中会用到的数据对象。 proc是当用户对varName作flags中指定的操作时，被激活的回调函数，其原型必须和以下定义匹配： typedef char *Tcl_VarTraceProc(ClientData clientData , Tcl_Interp *interp , char *name1 , char *name2 , int flags); 其中clientData、interp两个参数就指向Tcl_TraceVar中对应的参数，name1和name2两个参数给出要被跟踪的变量名，其含义同Tcl_SetVar2中的name1和name2。对于读操作，回调函数在Tcl_GetVar和Tcl_GetVar2 返回之前被激活，如果在回调函数中改变了变量的值，那么这个被修改了的值将被返回。对于写操作，回调函数当变量的值被修改后被激活，回调函数可以修改变量的值，并且这个值将作为Tcl_SetVar和Tcl_SetVar2 的结果。对于删除操作，回调函数在变量被删除之后被激活，所以在回调函数中不能访问这个变量。在变量跟踪的回调函数中可以调用Tcl_GetVar2 和Tcl_SetVar2 函数来读写被跟踪的变量，在回调函数中所有对变量的跟踪都被临时关掉了，所以对Tcl_GetVar2 和Tcl_SetVar2的调用不会激活回调函。回调函数成功返回NULL，失败返回包含错误信息的串。 8. Tcl_TraceVar2 函数原型： int Tcl_TraceVar2 (Tcl_Interp *interp, char * name1,char* name2, int flags, Tcl_VarTraceProc *proc, ClientData clientData) 这个函数的用法与Tcl_TraceVar的区别同Tcl_SetVar和Tcl_SetVar2 的区别。 9. Tcl_UntraceVar函数原型：Tcl_UntraceVar (Tcl_Interp *interp, char *varName,int flags, Tcl_VarTraceProc *proc, ClientData clientData) 第 8 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 这个函数把对一个变量的跟踪取消。各个参数的含义同Tcl_TraceVar。 10. Tcl_UntraceVar2 函数原型：Tcl_UntraceVar2 (Tcl_Interp *interp, char *name1,char *name2,int flags, Tcl_VarTraceProc *proc, ClientData clientData) 这个函数的用法与Tcl_UntraceVar的区别同Tcl_SetVar和Tcl_SetVar2 的区别。 11. Tcl_VarTraceInfo 函数原型： ClientData Tcl_VarTraceInfo (Tcl_Interp *interp, char *varName, int flags, Tcl_VarTraceProc *proc, ClientData prevClientData) 这个函数用于获取变量varName的跟踪信息。注意，flags的值只有TCL_GLOBAL_ONLY有效。如果prevClientData是NULL，那么函数返回最近一次变量的跟踪消息，没有跟踪消息就返回 NULL 。如果 prevClientData 非空，那么必须是上一次 Tcl_VarTraceInfo 的返回值，利用 Tcl_VarTraceInfo，我们可以递归得到变量的所有跟踪信息。 12. Tcl_VarTraceInfo2 函数原型： ClientData Tcl_VarTraceInfo2 (Tcl_Interp *interp, char *name1,char* name2, int flags, Tcl_VarTraceProc *proc, ClientData prevClientData) 这个函数的用法类似于Tcl_VarTraceInfo，区别同Tcl_SetVar和Tcl_SetVar2 的区别。 7 Hash表操作函数 Hash表是由一个个入口(entry)组成的，每个入口包含一个关键码(key)和一个值值(value)，在一个Hash表中关键码是唯一的，任意两个入口都必须有不同的关键码。通过关键码，Hash表可以快速找到它对应的入口和与之关联的值。Hash表对需要维护大量的数据并希望快速定位数据的应用程序是必不可少的。TCL通过一些库函数为用户提供了操作Hash表的能力。 1. Tcl_InitHashTable函数原型：void Tcl_InitHashTable(Tcl_HashTable *tablePtr, int keyType) 这个函数生成一个新的Hash表，并且把表的信息存储在*tablePtr中，keyType表示关键码的类型，其取值可以为以下几个： TCL_STRING_KEYS：表示关键码是字符串。 TCL_ONE_WORD_KEYS：表示关键码是一个single-world大小的值，如整数。其他：关键码的最后一种形式是整数数组，这时keyType指明整数数组中整数的个数，注意这时数组的大小必须一样。 2. Tcl_DeleteHashTable函数原型：void Tcl_DeleteHashTable(Tcl_HashTable *tablePtr) 这个函数删除Hash表上的所有入口(entry)，并释放相关的内存空间。 3. Tcl_CreateHashEntry函数原型：void Tcl_HashEntry *Tcl_CreateHashEntry(Tcl_HashTable *tablePtr, char *key,int *newPtr) 这个函数生成Hash 表tablePtr的一个关键码为 key 的新入口，如果新入口成功生成，那么 newPtr被设置为1，否则设置为0。第 9 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 4. Tcl_FindHashEntry函数原型：Tcl_HashEntry * Tcl_FindHashEntry(Tcl_HashTable *tablePtr, char *key) 这个函数在Hash表tablePtr中寻找关键码为key的入口，找到返回指向入口的指针，否则返回 NULL。 5. Tcl_DeleteHashEntry函数原型：Tcl_DeleteHashEntry(Tcl_HashEntry *entryPtr) 这个函数把入口entryPtr从它所在的Hash表中删除。 6. Tcl_GetHashValue函数原型：ClientData Tcl_GetHashValue(Tcl_HashEntry *entryPtr) 这个函数从入口entryPtr中得到对应的值。 7. Tcl_SetHashValue函数原型：voidTcl_SetHashValue (Tcl_HashEntry *entryPtr, ClientData value) 这个函数把value中的值设置到入口entryPtr中。 8. Tcl_GetHashKey函数原型：char *Tcl_GetHashKey(Tcl_HashEntry *entryPtr) 这个函数从入口entryPtr中获取关键码，返回关键码的字符串形式。 9. Tcl_FirstHashEntry函数原型：Tcl_HashEntry *Tcl_FirstHashEntry(Tcl_HashTable *tablePtr,Tcl_HashSearch *searchPtr) 这个函数开始搜索整个tablePtr指向的Hash表的元素，把搜索信息存放在searchPtr中，并返回 Hash表的第一个入口，如果Hash表为空返回NULL。 10. Tcl_NextHashEntry函数原型：Tcl_HashEntry *Tcl_NextHashEntry(Tcl_HashSearch *searchPtr) 这个函数返回searchPtr中的下一个入口，如果所有入口都已返回就返回NULL。这个函数和 Tcl_FirstHashEntry函数配合可以遍历整个Hash表的入口。 11. Tcl_HashStats函数原型： char *Tcl_HashStats(Tcl_HashTable *tablePtr) 这个函数用于获取Hash表tablePtr中入口的分布情况，分布情况以字符串形式返回。 8 字符串操作函数 TCL提供的这组字符串操作函数，可以实现动态字符串，字符串匹配和判断一个命令是否完整。 1. void Tcl_DStringInit函数原型：Tcl_DStringInit(Tcl_DString *dsPtr) 这个函数把dsPtr清空。 Tcl_DString是TCL定义的一个结构，用来表示一个动态字符串。 2. void Tcl_DStringAppend函数原型：char *Tcl_DStringAppend(Tcl_DString *dsPtr, char *string, int length) 这个函数把字符串string中的length个字符附加到dsPtr之后，并返回dsPtr的新值。如果length小于0，那么把string（包含NULL〕全附加到dsPtr之后。第 10 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- 3. void Tcl_DStringAppendElement函数原型： char *Tcl_DStringAppendElement(Tcl_DString *dsPtr, char *string) 这个函数把string转换成一个list成员并附加到dsPtr中（如果需要会加上一个分隔符〕。返回值为dsPtr的新值。 4. voidTcl_DStringFree函数原型：Tcl_DStringFree(Tcl_DString *dsPtr) 这个函数释放dsPtr中分配的所有内存，并把dsPtr置为空。 5. void Tcl_DStringResult函数原型： Tcl_DStringResult(Tcl_Interp *interp, Tcl_DString *dsPtr) 这个函数把dsPtr的值传给interp->result,并重新初始化dsPtr，把它置为空。 6. Tcl_CommandComplete函数原型：int Tcl_CommandComplete(char *cmd) 这个函数用于检查命令cmd是否完整，它会自动检查命令的参数个数及括号配对的情况，命令完整返回1，否则返回0。 7。 int Tcl_StringMatch(char *string, char *pattern) 如果字符串string匹配模式pattern，返回1，否则返回0。 9 TCL库函数的最新情况以上介绍的都是TCL7.6版本的库函数。在这些函数的内部实现中，所有的变量及其值都是以字符串形式来访问的，而使用字符串形式必然会涉及到频繁的字符串的比较和转换，降低TCL的解释执行速度。在TCL8.1以上版本，对函数的内部实现作了一些改进，以一个新的结构Tcl_Obj来代替了单纯的字符串表示。利用这个结构，可以一方面保持TCL库函数的前向兼容，另一方面可以提高TCL解释执行的速度。下面对Tcl_Obj结构作一介绍。在TCL中，Tcl_Obj结构定义如下： typedef struct Tcl_Obj { int refCount; char *bytes; int length; Tcl_ObjType *typePtr; union { long longValue; double doubleValue; VOID *otherValuePtr; struct { VOID *ptr1; VOID *ptr2; } twoPtrValue; } internalRep; 第 11 页，共 12 页 TCL库函数介绍 ---------------------------------------------------------------------------------------------------------------------------------------------------- } Tcl_Obj; 仔细研究这个结构，你会发现实际上这个结构中对一个对象用了两种表示方法： 1.字符串形式的表示：这由bytes和length两个分量来表示。字符串形式也是对象的外在表示形式，因为在TCL语言级，一切都看作字符串。但bytes为空是表示字符串表示形式无效。 2.对象的实际的类型： typePtr 结构表示对象的实际类型，联合类型internalRep用来存储对象的值。当typePtr为空时，表示这种表示方法无效。采用了这种内部表示，TCL可以当需要字符串形式时，就输出Tcl_Obj的字符串形式，需要对象的实际类型时就输出实际类型的值。其实现原理是：两种表示方法互相关联，每次修改了两种表示中的一种，并不立即修改另一种表示，而是把另外一种表示标记为无效。只有当需要另一种表示，才从改变了的那种表示转换得到所需要的表示。TCL试图利用这种方法来减少在运行时的转换工作，提高执行效率。但是这也给用户在使用上带来了不便，用户需要自己控制两种方式的有效无效状态，当然这只是对扩展TCL命令的语言的用户而言。虽然 TCL 的 8.1 以上版本作了扩展，但使用以前的函数并不受任何影响。对于如何使用 Tcl_Obj结构及与之相关的库函数来扩展TCL命令，将在参考了相关资料及充分实践的基础上作详细的介绍。第 12 页，共 12 页

TCL培训教程：综合指南

Products

Support

TCL培训教程：综合指南

Add this document to collection(s)

Add this document to saved

Suggest us how to improve StudyLib