/[dtapublic]/projs/trunk/shared_source/c_tcl_base_7_5_w_mods/tclcmdil.c
ViewVC logotype

Annotation of /projs/trunk/shared_source/c_tcl_base_7_5_w_mods/tclcmdil.c

Parent Directory Parent Directory | Revision Log Revision Log


Revision 29 - (hide annotations) (download)
Sat Oct 8 07:08:47 2016 UTC (8 years, 1 month ago) by dashley
Original Path: to_be_filed/sf_code/esrgpcpj/shared/tcl_base/tclcmdil.c
File MIME type: text/plain
File size: 92535 byte(s)
Directories relocated.
1 dashley 25 /* $Header: /cvsroot/esrg/sfesrg/esrgpcpj/shared/tcl_base/tclcmdil.c,v 1.1.1.1 2001/06/13 04:34:54 dtashley Exp $ */
2    
3     /*
4     * tclCmdIL.c --
5     *
6     * This file contains the top-level command routines for most of
7     * the Tcl built-in commands whose names begin with the letters
8     * I through L. It contains only commands in the generic core
9     * (i.e. those that don't depend much upon UNIX facilities).
10     *
11     * Copyright (c) 1987-1993 The Regents of the University of California.
12     * Copyright (c) 1993-1997 Lucent Technologies.
13     * Copyright (c) 1994-1997 Sun Microsystems, Inc.
14     * Copyright (c) 1998-1999 by Scriptics Corporation.
15     *
16     * See the file "license.terms" for information on usage and redistribution
17     * of this file, and for a DISCLAIMER OF ALL WARRANTIES.
18     *
19     * RCS: @(#) $Id: tclcmdil.c,v 1.1.1.1 2001/06/13 04:34:54 dtashley Exp $
20     */
21    
22     #include "tclInt.h"
23     #include "tclPort.h"
24     #include "tclCompile.h"
25     #include "tclRegexp.h"
26    
27     /*
28     * During execution of the "lsort" command, structures of the following
29     * type are used to arrange the objects being sorted into a collection
30     * of linked lists.
31     */
32    
33     typedef struct SortElement {
34     Tcl_Obj *objPtr; /* Object being sorted. */
35     int count; /* number of same elements in list */
36     struct SortElement *nextPtr; /* Next element in the list, or
37     * NULL for end of list. */
38     } SortElement;
39    
40     /*
41     * The "lsort" command needs to pass certain information down to the
42     * function that compares two list elements, and the comparison function
43     * needs to pass success or failure information back up to the top-level
44     * "lsort" command. The following structure is used to pass this
45     * information.
46     */
47    
48     typedef struct SortInfo {
49     int isIncreasing; /* Nonzero means sort in increasing order. */
50     int sortMode; /* The sort mode. One of SORTMODE_*
51     * values defined below */
52     Tcl_Obj *compareCmdPtr; /* The Tcl comparison command when sortMode
53     * is SORTMODE_COMMAND. Pre-initialized to
54     * hold base of command.*/
55     int index; /* If the -index option was specified, this
56     * holds the index of the list element
57     * to extract for comparison. If -index
58     * wasn't specified, this is -1. */
59     Tcl_Interp *interp; /* The interpreter in which the sortis
60     * being done. */
61     int resultCode; /* Completion code for the lsort command.
62     * If an error occurs during the sort this
63     * is changed from TCL_OK to TCL_ERROR. */
64     } SortInfo;
65    
66     /*
67     * The "sortMode" field of the SortInfo structure can take on any of the
68     * following values.
69     */
70    
71     #define SORTMODE_ASCII 0
72     #define SORTMODE_INTEGER 1
73     #define SORTMODE_REAL 2
74     #define SORTMODE_COMMAND 3
75     #define SORTMODE_DICTIONARY 4
76    
77     /*
78     * Forward declarations for procedures defined in this file:
79     */
80    
81     static void AppendLocals _ANSI_ARGS_((Tcl_Interp *interp,
82     Tcl_Obj *listPtr, char *pattern,
83     int includeLinks));
84     static int DictionaryCompare _ANSI_ARGS_((char *left,
85     char *right));
86     static int InfoArgsCmd _ANSI_ARGS_((ClientData dummy,
87     Tcl_Interp *interp, int objc,
88     Tcl_Obj *CONST objv[]));
89     static int InfoBodyCmd _ANSI_ARGS_((ClientData dummy,
90     Tcl_Interp *interp, int objc,
91     Tcl_Obj *CONST objv[]));
92     static int InfoCmdCountCmd _ANSI_ARGS_((ClientData dummy,
93     Tcl_Interp *interp, int objc,
94     Tcl_Obj *CONST objv[]));
95     static int InfoCommandsCmd _ANSI_ARGS_((ClientData dummy,
96     Tcl_Interp *interp, int objc,
97     Tcl_Obj *CONST objv[]));
98     static int InfoCompleteCmd _ANSI_ARGS_((ClientData dummy,
99     Tcl_Interp *interp, int objc,
100     Tcl_Obj *CONST objv[]));
101     static int InfoDefaultCmd _ANSI_ARGS_((ClientData dummy,
102     Tcl_Interp *interp, int objc,
103     Tcl_Obj *CONST objv[]));
104     static int InfoExistsCmd _ANSI_ARGS_((ClientData dummy,
105     Tcl_Interp *interp, int objc,
106     Tcl_Obj *CONST objv[]));
107     static int InfoGlobalsCmd _ANSI_ARGS_((ClientData dummy,
108     Tcl_Interp *interp, int objc,
109     Tcl_Obj *CONST objv[]));
110     static int InfoHostnameCmd _ANSI_ARGS_((ClientData dummy,
111     Tcl_Interp *interp, int objc,
112     Tcl_Obj *CONST objv[]));
113     static int InfoLevelCmd _ANSI_ARGS_((ClientData dummy,
114     Tcl_Interp *interp, int objc,
115     Tcl_Obj *CONST objv[]));
116     static int InfoLibraryCmd _ANSI_ARGS_((ClientData dummy,
117     Tcl_Interp *interp, int objc,
118     Tcl_Obj *CONST objv[]));
119     static int InfoLoadedCmd _ANSI_ARGS_((ClientData dummy,
120     Tcl_Interp *interp, int objc,
121     Tcl_Obj *CONST objv[]));
122     static int InfoLocalsCmd _ANSI_ARGS_((ClientData dummy,
123     Tcl_Interp *interp, int objc,
124     Tcl_Obj *CONST objv[]));
125     static int InfoNameOfExecutableCmd _ANSI_ARGS_((
126     ClientData dummy, Tcl_Interp *interp, int objc,
127     Tcl_Obj *CONST objv[]));
128     static int InfoPatchLevelCmd _ANSI_ARGS_((ClientData dummy,
129     Tcl_Interp *interp, int objc,
130     Tcl_Obj *CONST objv[]));
131     static int InfoProcsCmd _ANSI_ARGS_((ClientData dummy,
132     Tcl_Interp *interp, int objc,
133     Tcl_Obj *CONST objv[]));
134     static int InfoScriptCmd _ANSI_ARGS_((ClientData dummy,
135     Tcl_Interp *interp, int objc,
136     Tcl_Obj *CONST objv[]));
137     static int InfoSharedlibCmd _ANSI_ARGS_((ClientData dummy,
138     Tcl_Interp *interp, int objc,
139     Tcl_Obj *CONST objv[]));
140     static int InfoTclVersionCmd _ANSI_ARGS_((ClientData dummy,
141     Tcl_Interp *interp, int objc,
142     Tcl_Obj *CONST objv[]));
143     static int InfoVarsCmd _ANSI_ARGS_((ClientData dummy,
144     Tcl_Interp *interp, int objc,
145     Tcl_Obj *CONST objv[]));
146     static SortElement * MergeSort _ANSI_ARGS_((SortElement *headPt,
147     SortInfo *infoPtr));
148     static SortElement * MergeLists _ANSI_ARGS_((SortElement *leftPtr,
149     SortElement *rightPtr, SortInfo *infoPtr));
150     static int SortCompare _ANSI_ARGS_((Tcl_Obj *firstPtr,
151     Tcl_Obj *second, SortInfo *infoPtr));
152    
153     /*
154     *----------------------------------------------------------------------
155     *
156     * Tcl_IfObjCmd --
157     *
158     * This procedure is invoked to process the "if" Tcl command.
159     * See the user documentation for details on what it does.
160     *
161     * With the bytecode compiler, this procedure is only called when
162     * a command name is computed at runtime, and is "if" or the name
163     * to which "if" was renamed: e.g., "set z if; $z 1 {puts foo}"
164     *
165     * Results:
166     * A standard Tcl result.
167     *
168     * Side effects:
169     * See the user documentation.
170     *
171     *----------------------------------------------------------------------
172     */
173    
174     /* ARGSUSED */
175     int
176     Tcl_IfObjCmd(dummy, interp, objc, objv)
177     ClientData dummy; /* Not used. */
178     Tcl_Interp *interp; /* Current interpreter. */
179     int objc; /* Number of arguments. */
180     Tcl_Obj *CONST objv[]; /* Argument objects. */
181     {
182     int thenScriptIndex = 0; /* then script to be evaled after syntax check */
183     int i, result, value;
184     char *clause;
185     i = 1;
186     while (1) {
187     /*
188     * At this point in the loop, objv and objc refer to an expression
189     * to test, either for the main expression or an expression
190     * following an "elseif". The arguments after the expression must
191     * be "then" (optional) and a script to execute if the expression is
192     * true.
193     */
194    
195     if (i >= objc) {
196     clause = Tcl_GetString(objv[i-1]);
197     Tcl_AppendResult(interp, "wrong # args: no expression after \"",
198     clause, "\" argument", (char *) NULL);
199     return TCL_ERROR;
200     }
201     if (!thenScriptIndex) {
202     result = Tcl_ExprBooleanObj(interp, objv[i], &value);
203     if (result != TCL_OK) {
204     return result;
205     }
206     }
207     i++;
208     if (i >= objc) {
209     missingScript:
210     clause = Tcl_GetString(objv[i-1]);
211     Tcl_AppendResult(interp, "wrong # args: no script following \"",
212     clause, "\" argument", (char *) NULL);
213     return TCL_ERROR;
214     }
215     clause = Tcl_GetString(objv[i]);
216     if ((i < objc) && (strcmp(clause, "then") == 0)) {
217     i++;
218     }
219     if (i >= objc) {
220     goto missingScript;
221     }
222     if (value) {
223     thenScriptIndex = i;
224     value = 0;
225     }
226    
227     /*
228     * The expression evaluated to false. Skip the command, then
229     * see if there is an "else" or "elseif" clause.
230     */
231    
232     i++;
233     if (i >= objc) {
234     if (thenScriptIndex) {
235     return Tcl_EvalObjEx(interp, objv[thenScriptIndex], 0);
236     }
237     return TCL_OK;
238     }
239     clause = Tcl_GetString(objv[i]);
240     if ((clause[0] == 'e') && (strcmp(clause, "elseif") == 0)) {
241     i++;
242     continue;
243     }
244     break;
245     }
246    
247     /*
248     * Couldn't find a "then" or "elseif" clause to execute. Check now
249     * for an "else" clause. We know that there's at least one more
250     * argument when we get here.
251     */
252    
253     if (strcmp(clause, "else") == 0) {
254     i++;
255     if (i >= objc) {
256     Tcl_AppendResult(interp,
257     "wrong # args: no script following \"else\" argument",
258     (char *) NULL);
259     return TCL_ERROR;
260     }
261     }
262     if (i < objc - 1) {
263     Tcl_AppendResult(interp,
264     "wrong # args: extra words after \"else\" clause in \"if\" command",
265     (char *) NULL);
266     return TCL_ERROR;
267     }
268     if (thenScriptIndex) {
269     return Tcl_EvalObjEx(interp, objv[thenScriptIndex], 0);
270     }
271     return Tcl_EvalObjEx(interp, objv[i], 0);
272     }
273    
274     /*
275     *----------------------------------------------------------------------
276     *
277     * Tcl_IncrObjCmd --
278     *
279     * This procedure is invoked to process the "incr" Tcl command.
280     * See the user documentation for details on what it does.
281     *
282     * With the bytecode compiler, this procedure is only called when
283     * a command name is computed at runtime, and is "incr" or the name
284     * to which "incr" was renamed: e.g., "set z incr; $z i -1"
285     *
286     * Results:
287     * A standard Tcl result.
288     *
289     * Side effects:
290     * See the user documentation.
291     *
292     *----------------------------------------------------------------------
293     */
294    
295     /* ARGSUSED */
296     int
297     Tcl_IncrObjCmd(dummy, interp, objc, objv)
298     ClientData dummy; /* Not used. */
299     Tcl_Interp *interp; /* Current interpreter. */
300     int objc; /* Number of arguments. */
301     Tcl_Obj *CONST objv[]; /* Argument objects. */
302     {
303     long incrAmount;
304     Tcl_Obj *newValuePtr;
305    
306     if ((objc != 2) && (objc != 3)) {
307     Tcl_WrongNumArgs(interp, 1, objv, "varName ?increment?");
308     return TCL_ERROR;
309     }
310    
311     /*
312     * Calculate the amount to increment by.
313     */
314    
315     if (objc == 2) {
316     incrAmount = 1;
317     } else {
318     if (Tcl_GetLongFromObj(interp, objv[2], &incrAmount) != TCL_OK) {
319     Tcl_AddErrorInfo(interp, "\n (reading increment)");
320     return TCL_ERROR;
321     }
322     }
323    
324     /*
325     * Increment the variable's value.
326     */
327    
328     newValuePtr = TclIncrVar2(interp, objv[1], (Tcl_Obj *) NULL, incrAmount,
329     TCL_LEAVE_ERR_MSG);
330     if (newValuePtr == NULL) {
331     return TCL_ERROR;
332     }
333    
334     /*
335     * Set the interpreter's object result to refer to the variable's new
336     * value object.
337     */
338    
339     Tcl_SetObjResult(interp, newValuePtr);
340     return TCL_OK;
341     }
342    
343     /*
344     *----------------------------------------------------------------------
345     *
346     * Tcl_InfoObjCmd --
347     *
348     * This procedure is invoked to process the "info" Tcl command.
349     * See the user documentation for details on what it does.
350     *
351     * Results:
352     * A standard Tcl result.
353     *
354     * Side effects:
355     * See the user documentation.
356     *
357     *----------------------------------------------------------------------
358     */
359    
360     /* ARGSUSED */
361     int
362     Tcl_InfoObjCmd(clientData, interp, objc, objv)
363     ClientData clientData; /* Arbitrary value passed to the command. */
364     Tcl_Interp *interp; /* Current interpreter. */
365     int objc; /* Number of arguments. */
366     Tcl_Obj *CONST objv[]; /* Argument objects. */
367     {
368     static char *subCmds[] = {
369     "args", "body", "cmdcount", "commands",
370     "complete", "default", "exists", "globals",
371     "hostname", "level", "library", "loaded",
372     "locals", "nameofexecutable", "patchlevel", "procs",
373     "script", "sharedlibextension", "tclversion", "vars",
374     (char *) NULL};
375     enum ISubCmdIdx {
376     IArgsIdx, IBodyIdx, ICmdCountIdx, ICommandsIdx,
377     ICompleteIdx, IDefaultIdx, IExistsIdx, IGlobalsIdx,
378     IHostnameIdx, ILevelIdx, ILibraryIdx, ILoadedIdx,
379     ILocalsIdx, INameOfExecutableIdx, IPatchLevelIdx, IProcsIdx,
380     IScriptIdx, ISharedLibExtensionIdx, ITclVersionIdx, IVarsIdx
381     };
382     int index, result;
383    
384     if (objc < 2) {
385     Tcl_WrongNumArgs(interp, 1, objv, "option ?arg arg ...?");
386     return TCL_ERROR;
387     }
388    
389     result = Tcl_GetIndexFromObj(interp, objv[1], subCmds, "option", 0,
390     (int *) &index);
391     if (result != TCL_OK) {
392     return result;
393     }
394    
395     switch (index) {
396     case IArgsIdx:
397     result = InfoArgsCmd(clientData, interp, objc, objv);
398     break;
399     case IBodyIdx:
400     result = InfoBodyCmd(clientData, interp, objc, objv);
401     break;
402     case ICmdCountIdx:
403     result = InfoCmdCountCmd(clientData, interp, objc, objv);
404     break;
405     case ICommandsIdx:
406     result = InfoCommandsCmd(clientData, interp, objc, objv);
407     break;
408     case ICompleteIdx:
409     result = InfoCompleteCmd(clientData, interp, objc, objv);
410     break;
411     case IDefaultIdx:
412     result = InfoDefaultCmd(clientData, interp, objc, objv);
413     break;
414     case IExistsIdx:
415     result = InfoExistsCmd(clientData, interp, objc, objv);
416     break;
417     case IGlobalsIdx:
418     result = InfoGlobalsCmd(clientData, interp, objc, objv);
419     break;
420     case IHostnameIdx:
421     result = InfoHostnameCmd(clientData, interp, objc, objv);
422     break;
423     case ILevelIdx:
424     result = InfoLevelCmd(clientData, interp, objc, objv);
425     break;
426     case ILibraryIdx:
427     result = InfoLibraryCmd(clientData, interp, objc, objv);
428     break;
429     case ILoadedIdx:
430     result = InfoLoadedCmd(clientData, interp, objc, objv);
431     break;
432     case ILocalsIdx:
433     result = InfoLocalsCmd(clientData, interp, objc, objv);
434     break;
435     case INameOfExecutableIdx:
436     result = InfoNameOfExecutableCmd(clientData, interp, objc, objv);
437     break;
438     case IPatchLevelIdx:
439     result = InfoPatchLevelCmd(clientData, interp, objc, objv);
440     break;
441     case IProcsIdx:
442     result = InfoProcsCmd(clientData, interp, objc, objv);
443     break;
444     case IScriptIdx:
445     result = InfoScriptCmd(clientData, interp, objc, objv);
446     break;
447     case ISharedLibExtensionIdx:
448     result = InfoSharedlibCmd(clientData, interp, objc, objv);
449     break;
450     case ITclVersionIdx:
451     result = InfoTclVersionCmd(clientData, interp, objc, objv);
452     break;
453     case IVarsIdx:
454     result = InfoVarsCmd(clientData, interp, objc, objv);
455     break;
456     }
457     return result;
458     }
459    
460     /*
461     *----------------------------------------------------------------------
462     *
463     * InfoArgsCmd --
464     *
465     * Called to implement the "info args" command that returns the
466     * argument list for a procedure. Handles the following syntax:
467     *
468     * info args procName
469     *
470     * Results:
471     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
472     *
473     * Side effects:
474     * Returns a result in the interpreter's result object. If there is
475     * an error, the result is an error message.
476     *
477     *----------------------------------------------------------------------
478     */
479    
480     static int
481     InfoArgsCmd(dummy, interp, objc, objv)
482     ClientData dummy; /* Not used. */
483     Tcl_Interp *interp; /* Current interpreter. */
484     int objc; /* Number of arguments. */
485     Tcl_Obj *CONST objv[]; /* Argument objects. */
486     {
487     register Interp *iPtr = (Interp *) interp;
488     char *name;
489     Proc *procPtr;
490     CompiledLocal *localPtr;
491     Tcl_Obj *listObjPtr;
492    
493     if (objc != 3) {
494     Tcl_WrongNumArgs(interp, 2, objv, "procname");
495     return TCL_ERROR;
496     }
497    
498     name = Tcl_GetString(objv[2]);
499     procPtr = TclFindProc(iPtr, name);
500     if (procPtr == NULL) {
501     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
502     "\"", name, "\" isn't a procedure", (char *) NULL);
503     return TCL_ERROR;
504     }
505    
506     /*
507     * Build a return list containing the arguments.
508     */
509    
510     listObjPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
511     for (localPtr = procPtr->firstLocalPtr; localPtr != NULL;
512     localPtr = localPtr->nextPtr) {
513     if (TclIsVarArgument(localPtr)) {
514     Tcl_ListObjAppendElement(interp, listObjPtr,
515     Tcl_NewStringObj(localPtr->name, -1));
516     }
517     }
518     Tcl_SetObjResult(interp, listObjPtr);
519     return TCL_OK;
520     }
521    
522     /*
523     *----------------------------------------------------------------------
524     *
525     * InfoBodyCmd --
526     *
527     * Called to implement the "info body" command that returns the body
528     * for a procedure. Handles the following syntax:
529     *
530     * info body procName
531     *
532     * Results:
533     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
534     *
535     * Side effects:
536     * Returns a result in the interpreter's result object. If there is
537     * an error, the result is an error message.
538     *
539     *----------------------------------------------------------------------
540     */
541    
542     static int
543     InfoBodyCmd(dummy, interp, objc, objv)
544     ClientData dummy; /* Not used. */
545     Tcl_Interp *interp; /* Current interpreter. */
546     int objc; /* Number of arguments. */
547     Tcl_Obj *CONST objv[]; /* Argument objects. */
548     {
549     register Interp *iPtr = (Interp *) interp;
550     char *name;
551     Proc *procPtr;
552     Tcl_Obj *bodyPtr, *resultPtr;
553    
554     if (objc != 3) {
555     Tcl_WrongNumArgs(interp, 2, objv, "procname");
556     return TCL_ERROR;
557     }
558    
559     name = Tcl_GetString(objv[2]);
560     procPtr = TclFindProc(iPtr, name);
561     if (procPtr == NULL) {
562     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
563     "\"", name, "\" isn't a procedure", (char *) NULL);
564     return TCL_ERROR;
565     }
566    
567     /*
568     * We should not return a bytecompiled body. If it is precompiled,
569     * then the bodyPtr's string representation is bogus, since sources
570     * are not available. If it was just a bytecompiled body, then it
571     * is likely to not be of any use to the caller, as it was compiled
572     * for a separate procedure context [Bug: 3412], and noone else can
573     * reasonably use it.
574     * In order to make sure that later manipulations of the object do not
575     * invalidate the internal representation, we make a copy of the string
576     * representation and return that one, instead.
577     */
578    
579     bodyPtr = procPtr->bodyPtr;
580     resultPtr = bodyPtr;
581     if (bodyPtr->typePtr == &tclByteCodeType) {
582     resultPtr = Tcl_NewStringObj(bodyPtr->bytes, bodyPtr->length);
583     }
584    
585     Tcl_SetObjResult(interp, resultPtr);
586     return TCL_OK;
587     }
588    
589     /*
590     *----------------------------------------------------------------------
591     *
592     * InfoCmdCountCmd --
593     *
594     * Called to implement the "info cmdcount" command that returns the
595     * number of commands that have been executed. Handles the following
596     * syntax:
597     *
598     * info cmdcount
599     *
600     * Results:
601     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
602     *
603     * Side effects:
604     * Returns a result in the interpreter's result object. If there is
605     * an error, the result is an error message.
606     *
607     *----------------------------------------------------------------------
608     */
609    
610     static int
611     InfoCmdCountCmd(dummy, interp, objc, objv)
612     ClientData dummy; /* Not used. */
613     Tcl_Interp *interp; /* Current interpreter. */
614     int objc; /* Number of arguments. */
615     Tcl_Obj *CONST objv[]; /* Argument objects. */
616     {
617     Interp *iPtr = (Interp *) interp;
618    
619     if (objc != 2) {
620     Tcl_WrongNumArgs(interp, 2, objv, NULL);
621     return TCL_ERROR;
622     }
623    
624     Tcl_SetIntObj(Tcl_GetObjResult(interp), iPtr->cmdCount);
625     return TCL_OK;
626     }
627    
628     /*
629     *----------------------------------------------------------------------
630     *
631     * InfoCommandsCmd --
632     *
633     * Called to implement the "info commands" command that returns the
634     * list of commands in the interpreter that match an optional pattern.
635     * The pattern, if any, consists of an optional sequence of namespace
636     * names separated by "::" qualifiers, which is followed by a
637     * glob-style pattern that restricts which commands are returned.
638     * Handles the following syntax:
639     *
640     * info commands ?pattern?
641     *
642     * Results:
643     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
644     *
645     * Side effects:
646     * Returns a result in the interpreter's result object. If there is
647     * an error, the result is an error message.
648     *
649     *----------------------------------------------------------------------
650     */
651    
652     static int
653     InfoCommandsCmd(dummy, interp, objc, objv)
654     ClientData dummy; /* Not used. */
655     Tcl_Interp *interp; /* Current interpreter. */
656     int objc; /* Number of arguments. */
657     Tcl_Obj *CONST objv[]; /* Argument objects. */
658     {
659     char *cmdName, *pattern, *simplePattern;
660     register Tcl_HashEntry *entryPtr;
661     Tcl_HashSearch search;
662     Namespace *nsPtr;
663     Namespace *globalNsPtr = (Namespace *) Tcl_GetGlobalNamespace(interp);
664     Namespace *currNsPtr = (Namespace *) Tcl_GetCurrentNamespace(interp);
665     Tcl_Obj *listPtr, *elemObjPtr;
666     int specificNsInPattern = 0; /* Init. to avoid compiler warning. */
667     Tcl_Command cmd;
668    
669     /*
670     * Get the pattern and find the "effective namespace" in which to
671     * list commands.
672     */
673    
674     if (objc == 2) {
675     simplePattern = NULL;
676     nsPtr = currNsPtr;
677     specificNsInPattern = 0;
678     } else if (objc == 3) {
679     /*
680     * From the pattern, get the effective namespace and the simple
681     * pattern (no namespace qualifiers or ::'s) at the end. If an
682     * error was found while parsing the pattern, return it. Otherwise,
683     * if the namespace wasn't found, just leave nsPtr NULL: we will
684     * return an empty list since no commands there can be found.
685     */
686    
687     Namespace *dummy1NsPtr, *dummy2NsPtr;
688    
689    
690     pattern = Tcl_GetString(objv[2]);
691     TclGetNamespaceForQualName(interp, pattern, (Namespace *) NULL,
692     /*flags*/ 0, &nsPtr, &dummy1NsPtr, &dummy2NsPtr, &simplePattern);
693    
694     if (nsPtr != NULL) { /* we successfully found the pattern's ns */
695     specificNsInPattern = (strcmp(simplePattern, pattern) != 0);
696     }
697     } else {
698     Tcl_WrongNumArgs(interp, 2, objv, "?pattern?");
699     return TCL_ERROR;
700     }
701    
702     /*
703     * Scan through the effective namespace's command table and create a
704     * list with all commands that match the pattern. If a specific
705     * namespace was requested in the pattern, qualify the command names
706     * with the namespace name.
707     */
708    
709     listPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
710    
711     if (nsPtr != NULL) {
712     entryPtr = Tcl_FirstHashEntry(&nsPtr->cmdTable, &search);
713     while (entryPtr != NULL) {
714     cmdName = Tcl_GetHashKey(&nsPtr->cmdTable, entryPtr);
715     if ((simplePattern == NULL)
716     || Tcl_StringMatch(cmdName, simplePattern)) {
717     if (specificNsInPattern) {
718     cmd = (Tcl_Command) Tcl_GetHashValue(entryPtr);
719     elemObjPtr = Tcl_NewObj();
720     Tcl_GetCommandFullName(interp, cmd, elemObjPtr);
721     } else {
722     elemObjPtr = Tcl_NewStringObj(cmdName, -1);
723     }
724     Tcl_ListObjAppendElement(interp, listPtr, elemObjPtr);
725     }
726     entryPtr = Tcl_NextHashEntry(&search);
727     }
728    
729     /*
730     * If the effective namespace isn't the global :: namespace, and a
731     * specific namespace wasn't requested in the pattern, then add in
732     * all global :: commands that match the simple pattern. Of course,
733     * we add in only those commands that aren't hidden by a command in
734     * the effective namespace.
735     */
736    
737     if ((nsPtr != globalNsPtr) && !specificNsInPattern) {
738     entryPtr = Tcl_FirstHashEntry(&globalNsPtr->cmdTable, &search);
739     while (entryPtr != NULL) {
740     cmdName = Tcl_GetHashKey(&globalNsPtr->cmdTable, entryPtr);
741     if ((simplePattern == NULL)
742     || Tcl_StringMatch(cmdName, simplePattern)) {
743     if (Tcl_FindHashEntry(&nsPtr->cmdTable, cmdName) == NULL) {
744     Tcl_ListObjAppendElement(interp, listPtr,
745     Tcl_NewStringObj(cmdName, -1));
746     }
747     }
748     entryPtr = Tcl_NextHashEntry(&search);
749     }
750     }
751     }
752    
753     Tcl_SetObjResult(interp, listPtr);
754     return TCL_OK;
755     }
756    
757     /*
758     *----------------------------------------------------------------------
759     *
760     * InfoCompleteCmd --
761     *
762     * Called to implement the "info complete" command that determines
763     * whether a string is a complete Tcl command. Handles the following
764     * syntax:
765     *
766     * info complete command
767     *
768     * Results:
769     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
770     *
771     * Side effects:
772     * Returns a result in the interpreter's result object. If there is
773     * an error, the result is an error message.
774     *
775     *----------------------------------------------------------------------
776     */
777    
778     static int
779     InfoCompleteCmd(dummy, interp, objc, objv)
780     ClientData dummy; /* Not used. */
781     Tcl_Interp *interp; /* Current interpreter. */
782     int objc; /* Number of arguments. */
783     Tcl_Obj *CONST objv[]; /* Argument objects. */
784     {
785     if (objc != 3) {
786     Tcl_WrongNumArgs(interp, 2, objv, "command");
787     return TCL_ERROR;
788     }
789    
790     if (TclObjCommandComplete(objv[2])) {
791     Tcl_SetIntObj(Tcl_GetObjResult(interp), 1);
792     } else {
793     Tcl_SetIntObj(Tcl_GetObjResult(interp), 0);
794     }
795    
796     return TCL_OK;
797     }
798    
799     /*
800     *----------------------------------------------------------------------
801     *
802     * InfoDefaultCmd --
803     *
804     * Called to implement the "info default" command that returns the
805     * default value for a procedure argument. Handles the following
806     * syntax:
807     *
808     * info default procName arg varName
809     *
810     * Results:
811     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
812     *
813     * Side effects:
814     * Returns a result in the interpreter's result object. If there is
815     * an error, the result is an error message.
816     *
817     *----------------------------------------------------------------------
818     */
819    
820     static int
821     InfoDefaultCmd(dummy, interp, objc, objv)
822     ClientData dummy; /* Not used. */
823     Tcl_Interp *interp; /* Current interpreter. */
824     int objc; /* Number of arguments. */
825     Tcl_Obj *CONST objv[]; /* Argument objects. */
826     {
827     Interp *iPtr = (Interp *) interp;
828     char *procName, *argName, *varName;
829     Proc *procPtr;
830     CompiledLocal *localPtr;
831     Tcl_Obj *valueObjPtr;
832    
833     if (objc != 5) {
834     Tcl_WrongNumArgs(interp, 2, objv, "procname arg varname");
835     return TCL_ERROR;
836     }
837    
838     procName = Tcl_GetString(objv[2]);
839     argName = Tcl_GetString(objv[3]);
840    
841     procPtr = TclFindProc(iPtr, procName);
842     if (procPtr == NULL) {
843     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
844     "\"", procName, "\" isn't a procedure", (char *) NULL);
845     return TCL_ERROR;
846     }
847    
848     for (localPtr = procPtr->firstLocalPtr; localPtr != NULL;
849     localPtr = localPtr->nextPtr) {
850     if (TclIsVarArgument(localPtr)
851     && (strcmp(argName, localPtr->name) == 0)) {
852     if (localPtr->defValuePtr != NULL) {
853     valueObjPtr = Tcl_ObjSetVar2(interp, objv[4], NULL,
854     localPtr->defValuePtr, 0);
855     if (valueObjPtr == NULL) {
856     defStoreError:
857     varName = Tcl_GetString(objv[4]);
858     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
859     "couldn't store default value in variable \"",
860     varName, "\"", (char *) NULL);
861     return TCL_ERROR;
862     }
863     Tcl_SetIntObj(Tcl_GetObjResult(interp), 1);
864     } else {
865     Tcl_Obj *nullObjPtr = Tcl_NewObj();
866     valueObjPtr = Tcl_ObjSetVar2(interp, objv[4], NULL,
867     nullObjPtr, 0);
868     if (valueObjPtr == NULL) {
869     Tcl_DecrRefCount(nullObjPtr); /* free unneeded obj */
870     goto defStoreError;
871     }
872     Tcl_SetIntObj(Tcl_GetObjResult(interp), 0);
873     }
874     return TCL_OK;
875     }
876     }
877    
878     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
879     "procedure \"", procName, "\" doesn't have an argument \"",
880     argName, "\"", (char *) NULL);
881     return TCL_ERROR;
882     }
883    
884     /*
885     *----------------------------------------------------------------------
886     *
887     * InfoExistsCmd --
888     *
889     * Called to implement the "info exists" command that determines
890     * whether a variable exists. Handles the following syntax:
891     *
892     * info exists varName
893     *
894     * Results:
895     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
896     *
897     * Side effects:
898     * Returns a result in the interpreter's result object. If there is
899     * an error, the result is an error message.
900     *
901     *----------------------------------------------------------------------
902     */
903    
904     static int
905     InfoExistsCmd(dummy, interp, objc, objv)
906     ClientData dummy; /* Not used. */
907     Tcl_Interp *interp; /* Current interpreter. */
908     int objc; /* Number of arguments. */
909     Tcl_Obj *CONST objv[]; /* Argument objects. */
910     {
911     char *varName;
912     Var *varPtr;
913    
914     if (objc != 3) {
915     Tcl_WrongNumArgs(interp, 2, objv, "varName");
916     return TCL_ERROR;
917     }
918    
919     varName = Tcl_GetString(objv[2]);
920     varPtr = TclVarTraceExists(interp, varName);
921     if ((varPtr != NULL) && !TclIsVarUndefined(varPtr)) {
922     Tcl_SetIntObj(Tcl_GetObjResult(interp), 1);
923     } else {
924     Tcl_SetIntObj(Tcl_GetObjResult(interp), 0);
925     }
926     return TCL_OK;
927     }
928    
929     /*
930     *----------------------------------------------------------------------
931     *
932     * InfoGlobalsCmd --
933     *
934     * Called to implement the "info globals" command that returns the list
935     * of global variables matching an optional pattern. Handles the
936     * following syntax:
937     *
938     * info globals ?pattern?
939     *
940     * Results:
941     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
942     *
943     * Side effects:
944     * Returns a result in the interpreter's result object. If there is
945     * an error, the result is an error message.
946     *
947     *----------------------------------------------------------------------
948     */
949    
950     static int
951     InfoGlobalsCmd(dummy, interp, objc, objv)
952     ClientData dummy; /* Not used. */
953     Tcl_Interp *interp; /* Current interpreter. */
954     int objc; /* Number of arguments. */
955     Tcl_Obj *CONST objv[]; /* Argument objects. */
956     {
957     char *varName, *pattern;
958     Namespace *globalNsPtr = (Namespace *) Tcl_GetGlobalNamespace(interp);
959     register Tcl_HashEntry *entryPtr;
960     Tcl_HashSearch search;
961     Var *varPtr;
962     Tcl_Obj *listPtr;
963    
964     if (objc == 2) {
965     pattern = NULL;
966     } else if (objc == 3) {
967     pattern = Tcl_GetString(objv[2]);
968     } else {
969     Tcl_WrongNumArgs(interp, 2, objv, "?pattern?");
970     return TCL_ERROR;
971     }
972    
973     /*
974     * Scan through the global :: namespace's variable table and create a
975     * list of all global variables that match the pattern.
976     */
977    
978     listPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
979     for (entryPtr = Tcl_FirstHashEntry(&globalNsPtr->varTable, &search);
980     entryPtr != NULL;
981     entryPtr = Tcl_NextHashEntry(&search)) {
982     varPtr = (Var *) Tcl_GetHashValue(entryPtr);
983     if (TclIsVarUndefined(varPtr)) {
984     continue;
985     }
986     varName = Tcl_GetHashKey(&globalNsPtr->varTable, entryPtr);
987     if ((pattern == NULL) || Tcl_StringMatch(varName, pattern)) {
988     Tcl_ListObjAppendElement(interp, listPtr,
989     Tcl_NewStringObj(varName, -1));
990     }
991     }
992     Tcl_SetObjResult(interp, listPtr);
993     return TCL_OK;
994     }
995    
996     /*
997     *----------------------------------------------------------------------
998     *
999     * InfoHostnameCmd --
1000     *
1001     * Called to implement the "info hostname" command that returns the
1002     * host name. Handles the following syntax:
1003     *
1004     * info hostname
1005     *
1006     * Results:
1007     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1008     *
1009     * Side effects:
1010     * Returns a result in the interpreter's result object. If there is
1011     * an error, the result is an error message.
1012     *
1013     *----------------------------------------------------------------------
1014     */
1015    
1016     static int
1017     InfoHostnameCmd(dummy, interp, objc, objv)
1018     ClientData dummy; /* Not used. */
1019     Tcl_Interp *interp; /* Current interpreter. */
1020     int objc; /* Number of arguments. */
1021     Tcl_Obj *CONST objv[]; /* Argument objects. */
1022     {
1023     char *name;
1024     if (objc != 2) {
1025     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1026     return TCL_ERROR;
1027     }
1028    
1029     name = Tcl_GetHostName();
1030     if (name) {
1031     Tcl_SetStringObj(Tcl_GetObjResult(interp), name, -1);
1032     return TCL_OK;
1033     } else {
1034     Tcl_SetStringObj(Tcl_GetObjResult(interp),
1035     "unable to determine name of host", -1);
1036     return TCL_ERROR;
1037     }
1038     }
1039    
1040     /*
1041     *----------------------------------------------------------------------
1042     *
1043     * InfoLevelCmd --
1044     *
1045     * Called to implement the "info level" command that returns
1046     * information about the call stack. Handles the following syntax:
1047     *
1048     * info level ?number?
1049     *
1050     * Results:
1051     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1052     *
1053     * Side effects:
1054     * Returns a result in the interpreter's result object. If there is
1055     * an error, the result is an error message.
1056     *
1057     *----------------------------------------------------------------------
1058     */
1059    
1060     static int
1061     InfoLevelCmd(dummy, interp, objc, objv)
1062     ClientData dummy; /* Not used. */
1063     Tcl_Interp *interp; /* Current interpreter. */
1064     int objc; /* Number of arguments. */
1065     Tcl_Obj *CONST objv[]; /* Argument objects. */
1066     {
1067     Interp *iPtr = (Interp *) interp;
1068     int level;
1069     CallFrame *framePtr;
1070     Tcl_Obj *listPtr;
1071    
1072     if (objc == 2) { /* just "info level" */
1073     if (iPtr->varFramePtr == NULL) {
1074     Tcl_SetIntObj(Tcl_GetObjResult(interp), 0);
1075     } else {
1076     Tcl_SetIntObj(Tcl_GetObjResult(interp), iPtr->varFramePtr->level);
1077     }
1078     return TCL_OK;
1079     } else if (objc == 3) {
1080     if (Tcl_GetIntFromObj(interp, objv[2], &level) != TCL_OK) {
1081     return TCL_ERROR;
1082     }
1083     if (level <= 0) {
1084     if (iPtr->varFramePtr == NULL) {
1085     levelError:
1086     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
1087     "bad level \"",
1088     Tcl_GetString(objv[2]),
1089     "\"", (char *) NULL);
1090     return TCL_ERROR;
1091     }
1092     level += iPtr->varFramePtr->level;
1093     }
1094     for (framePtr = iPtr->varFramePtr; framePtr != NULL;
1095     framePtr = framePtr->callerVarPtr) {
1096     if (framePtr->level == level) {
1097     break;
1098     }
1099     }
1100     if (framePtr == NULL) {
1101     goto levelError;
1102     }
1103    
1104     listPtr = Tcl_NewListObj(framePtr->objc, framePtr->objv);
1105     Tcl_SetObjResult(interp, listPtr);
1106     return TCL_OK;
1107     }
1108    
1109     Tcl_WrongNumArgs(interp, 2, objv, "?number?");
1110     return TCL_ERROR;
1111     }
1112    
1113     /*
1114     *----------------------------------------------------------------------
1115     *
1116     * InfoLibraryCmd --
1117     *
1118     * Called to implement the "info library" command that returns the
1119     * library directory for the Tcl installation. Handles the following
1120     * syntax:
1121     *
1122     * info library
1123     *
1124     * Results:
1125     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1126     *
1127     * Side effects:
1128     * Returns a result in the interpreter's result object. If there is
1129     * an error, the result is an error message.
1130     *
1131     *----------------------------------------------------------------------
1132     */
1133    
1134     static int
1135     InfoLibraryCmd(dummy, interp, objc, objv)
1136     ClientData dummy; /* Not used. */
1137     Tcl_Interp *interp; /* Current interpreter. */
1138     int objc; /* Number of arguments. */
1139     Tcl_Obj *CONST objv[]; /* Argument objects. */
1140     {
1141     char *libDirName;
1142    
1143     if (objc != 2) {
1144     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1145     return TCL_ERROR;
1146     }
1147    
1148     libDirName = Tcl_GetVar(interp, "tcl_library", TCL_GLOBAL_ONLY);
1149     if (libDirName != NULL) {
1150     Tcl_SetStringObj(Tcl_GetObjResult(interp), libDirName, -1);
1151     return TCL_OK;
1152     }
1153     Tcl_SetStringObj(Tcl_GetObjResult(interp),
1154     "no library has been specified for Tcl", -1);
1155     return TCL_ERROR;
1156     }
1157    
1158     /*
1159     *----------------------------------------------------------------------
1160     *
1161     * InfoLoadedCmd --
1162     *
1163     * Called to implement the "info loaded" command that returns the
1164     * packages that have been loaded into an interpreter. Handles the
1165     * following syntax:
1166     *
1167     * info loaded ?interp?
1168     *
1169     * Results:
1170     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1171     *
1172     * Side effects:
1173     * Returns a result in the interpreter's result object. If there is
1174     * an error, the result is an error message.
1175     *
1176     *----------------------------------------------------------------------
1177     */
1178    
1179     static int
1180     InfoLoadedCmd(dummy, interp, objc, objv)
1181     ClientData dummy; /* Not used. */
1182     Tcl_Interp *interp; /* Current interpreter. */
1183     int objc; /* Number of arguments. */
1184     Tcl_Obj *CONST objv[]; /* Argument objects. */
1185     {
1186     char *interpName;
1187     int result;
1188    
1189     if ((objc != 2) && (objc != 3)) {
1190     Tcl_WrongNumArgs(interp, 2, objv, "?interp?");
1191     return TCL_ERROR;
1192     }
1193    
1194     if (objc == 2) { /* get loaded pkgs in all interpreters */
1195     interpName = NULL;
1196     } else { /* get pkgs just in specified interp */
1197     interpName = Tcl_GetString(objv[2]);
1198     }
1199     result = TclGetLoadedPackages(interp, interpName);
1200     return result;
1201     }
1202    
1203     /*
1204     *----------------------------------------------------------------------
1205     *
1206     * InfoLocalsCmd --
1207     *
1208     * Called to implement the "info locals" command to return a list of
1209     * local variables that match an optional pattern. Handles the
1210     * following syntax:
1211     *
1212     * info locals ?pattern?
1213     *
1214     * Results:
1215     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1216     *
1217     * Side effects:
1218     * Returns a result in the interpreter's result object. If there is
1219     * an error, the result is an error message.
1220     *
1221     *----------------------------------------------------------------------
1222     */
1223    
1224     static int
1225     InfoLocalsCmd(dummy, interp, objc, objv)
1226     ClientData dummy; /* Not used. */
1227     Tcl_Interp *interp; /* Current interpreter. */
1228     int objc; /* Number of arguments. */
1229     Tcl_Obj *CONST objv[]; /* Argument objects. */
1230     {
1231     Interp *iPtr = (Interp *) interp;
1232     char *pattern;
1233     Tcl_Obj *listPtr;
1234    
1235     if (objc == 2) {
1236     pattern = NULL;
1237     } else if (objc == 3) {
1238     pattern = Tcl_GetString(objv[2]);
1239     } else {
1240     Tcl_WrongNumArgs(interp, 2, objv, "?pattern?");
1241     return TCL_ERROR;
1242     }
1243    
1244     if (iPtr->varFramePtr == NULL || !iPtr->varFramePtr->isProcCallFrame) {
1245     return TCL_OK;
1246     }
1247    
1248     /*
1249     * Return a list containing names of first the compiled locals (i.e. the
1250     * ones stored in the call frame), then the variables in the local hash
1251     * table (if one exists).
1252     */
1253    
1254     listPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
1255     AppendLocals(interp, listPtr, pattern, 0);
1256     Tcl_SetObjResult(interp, listPtr);
1257     return TCL_OK;
1258     }
1259    
1260     /*
1261     *----------------------------------------------------------------------
1262     *
1263     * AppendLocals --
1264     *
1265     * Append the local variables for the current frame to the
1266     * specified list object.
1267     *
1268     * Results:
1269     * None.
1270     *
1271     * Side effects:
1272     * None.
1273     *
1274     *----------------------------------------------------------------------
1275     */
1276    
1277     static void
1278     AppendLocals(interp, listPtr, pattern, includeLinks)
1279     Tcl_Interp *interp; /* Current interpreter. */
1280     Tcl_Obj *listPtr; /* List object to append names to. */
1281     char *pattern; /* Pattern to match against. */
1282     int includeLinks; /* 1 if upvars should be included, else 0. */
1283     {
1284     Interp *iPtr = (Interp *) interp;
1285     CompiledLocal *localPtr;
1286     Var *varPtr;
1287     int i, localVarCt;
1288     char *varName;
1289     Tcl_HashTable *localVarTablePtr;
1290     register Tcl_HashEntry *entryPtr;
1291     Tcl_HashSearch search;
1292    
1293     localPtr = iPtr->varFramePtr->procPtr->firstLocalPtr;
1294     localVarCt = iPtr->varFramePtr->numCompiledLocals;
1295     varPtr = iPtr->varFramePtr->compiledLocals;
1296     localVarTablePtr = iPtr->varFramePtr->varTablePtr;
1297    
1298     for (i = 0; i < localVarCt; i++) {
1299     /*
1300     * Skip nameless (temporary) variables and undefined variables
1301     */
1302    
1303     if (!TclIsVarTemporary(localPtr) && !TclIsVarUndefined(varPtr)) {
1304     varName = varPtr->name;
1305     if ((pattern == NULL) || Tcl_StringMatch(varName, pattern)) {
1306     Tcl_ListObjAppendElement(interp, listPtr,
1307     Tcl_NewStringObj(varName, -1));
1308     }
1309     }
1310     varPtr++;
1311     localPtr = localPtr->nextPtr;
1312     }
1313    
1314     if (localVarTablePtr != NULL) {
1315     for (entryPtr = Tcl_FirstHashEntry(localVarTablePtr, &search);
1316     entryPtr != NULL;
1317     entryPtr = Tcl_NextHashEntry(&search)) {
1318     varPtr = (Var *) Tcl_GetHashValue(entryPtr);
1319     if (!TclIsVarUndefined(varPtr)
1320     && (includeLinks || !TclIsVarLink(varPtr))) {
1321     varName = Tcl_GetHashKey(localVarTablePtr, entryPtr);
1322     if ((pattern == NULL)
1323     || Tcl_StringMatch(varName, pattern)) {
1324     Tcl_ListObjAppendElement(interp, listPtr,
1325     Tcl_NewStringObj(varName, -1));
1326     }
1327     }
1328     }
1329     }
1330     }
1331    
1332     /*
1333     *----------------------------------------------------------------------
1334     *
1335     * InfoNameOfExecutableCmd --
1336     *
1337     * Called to implement the "info nameofexecutable" command that returns
1338     * the name of the binary file running this application. Handles the
1339     * following syntax:
1340     *
1341     * info nameofexecutable
1342     *
1343     * Results:
1344     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1345     *
1346     * Side effects:
1347     * Returns a result in the interpreter's result object. If there is
1348     * an error, the result is an error message.
1349     *
1350     *----------------------------------------------------------------------
1351     */
1352    
1353     static int
1354     InfoNameOfExecutableCmd(dummy, interp, objc, objv)
1355     ClientData dummy; /* Not used. */
1356     Tcl_Interp *interp; /* Current interpreter. */
1357     int objc; /* Number of arguments. */
1358     Tcl_Obj *CONST objv[]; /* Argument objects. */
1359     {
1360     CONST char *nameOfExecutable;
1361    
1362     if (objc != 2) {
1363     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1364     return TCL_ERROR;
1365     }
1366    
1367     nameOfExecutable = Tcl_GetNameOfExecutable();
1368    
1369     if (nameOfExecutable != NULL) {
1370     Tcl_SetStringObj(Tcl_GetObjResult(interp), (char *)nameOfExecutable, -1);
1371     }
1372     return TCL_OK;
1373     }
1374    
1375     /*
1376     *----------------------------------------------------------------------
1377     *
1378     * InfoPatchLevelCmd --
1379     *
1380     * Called to implement the "info patchlevel" command that returns the
1381     * default value for an argument to a procedure. Handles the following
1382     * syntax:
1383     *
1384     * info patchlevel
1385     *
1386     * Results:
1387     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1388     *
1389     * Side effects:
1390     * Returns a result in the interpreter's result object. If there is
1391     * an error, the result is an error message.
1392     *
1393     *----------------------------------------------------------------------
1394     */
1395    
1396     static int
1397     InfoPatchLevelCmd(dummy, interp, objc, objv)
1398     ClientData dummy; /* Not used. */
1399     Tcl_Interp *interp; /* Current interpreter. */
1400     int objc; /* Number of arguments. */
1401     Tcl_Obj *CONST objv[]; /* Argument objects. */
1402     {
1403     char *patchlevel;
1404    
1405     if (objc != 2) {
1406     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1407     return TCL_ERROR;
1408     }
1409    
1410     patchlevel = Tcl_GetVar(interp, "tcl_patchLevel",
1411     (TCL_GLOBAL_ONLY | TCL_LEAVE_ERR_MSG));
1412     if (patchlevel != NULL) {
1413     Tcl_SetStringObj(Tcl_GetObjResult(interp), patchlevel, -1);
1414     return TCL_OK;
1415     }
1416     return TCL_ERROR;
1417     }
1418    
1419     /*
1420     *----------------------------------------------------------------------
1421     *
1422     * InfoProcsCmd --
1423     *
1424     * Called to implement the "info procs" command that returns the
1425     * list of procedures in the interpreter that match an optional pattern.
1426     * The pattern, if any, consists of an optional sequence of namespace
1427     * names separated by "::" qualifiers, which is followed by a
1428     * glob-style pattern that restricts which commands are returned.
1429     * Handles the following syntax:
1430     *
1431     * info procs ?pattern?
1432     *
1433     * Results:
1434     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1435     *
1436     * Side effects:
1437     * Returns a result in the interpreter's result object. If there is
1438     * an error, the result is an error message.
1439     *
1440     *----------------------------------------------------------------------
1441     */
1442    
1443     static int
1444     InfoProcsCmd(dummy, interp, objc, objv)
1445     ClientData dummy; /* Not used. */
1446     Tcl_Interp *interp; /* Current interpreter. */
1447     int objc; /* Number of arguments. */
1448     Tcl_Obj *CONST objv[]; /* Argument objects. */
1449     {
1450     char *cmdName, *pattern, *simplePattern;
1451     Namespace *nsPtr;
1452     #ifdef INFO_PROCS_SEARCH_GLOBAL_NS
1453     Namespace *globalNsPtr = (Namespace *) Tcl_GetGlobalNamespace(interp);
1454     #endif
1455     Namespace *currNsPtr = (Namespace *) Tcl_GetCurrentNamespace(interp);
1456     Tcl_Obj *listPtr, *elemObjPtr;
1457     int specificNsInPattern = 0; /* Init. to avoid compiler warning. */
1458     register Tcl_HashEntry *entryPtr;
1459     Tcl_HashSearch search;
1460     Command *cmdPtr, *realCmdPtr;
1461    
1462     /*
1463     * Get the pattern and find the "effective namespace" in which to
1464     * list procs.
1465     */
1466    
1467     if (objc == 2) {
1468     simplePattern = NULL;
1469     nsPtr = currNsPtr;
1470     specificNsInPattern = 0;
1471     } else if (objc == 3) {
1472     /*
1473     * From the pattern, get the effective namespace and the simple
1474     * pattern (no namespace qualifiers or ::'s) at the end. If an
1475     * error was found while parsing the pattern, return it. Otherwise,
1476     * if the namespace wasn't found, just leave nsPtr NULL: we will
1477     * return an empty list since no commands there can be found.
1478     */
1479    
1480     Namespace *dummy1NsPtr, *dummy2NsPtr;
1481    
1482     pattern = Tcl_GetString(objv[2]);
1483     TclGetNamespaceForQualName(interp, pattern, (Namespace *) NULL,
1484     /*flags*/ 0, &nsPtr, &dummy1NsPtr, &dummy2NsPtr,
1485     &simplePattern);
1486    
1487     if (nsPtr != NULL) { /* we successfully found the pattern's ns */
1488     specificNsInPattern = (strcmp(simplePattern, pattern) != 0);
1489     }
1490     } else {
1491     Tcl_WrongNumArgs(interp, 2, objv, "?pattern?");
1492     return TCL_ERROR;
1493     }
1494    
1495     /*
1496     * Scan through the effective namespace's command table and create a
1497     * list with all procs that match the pattern. If a specific
1498     * namespace was requested in the pattern, qualify the command names
1499     * with the namespace name.
1500     */
1501    
1502     listPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
1503     if (nsPtr != NULL) {
1504     entryPtr = Tcl_FirstHashEntry(&nsPtr->cmdTable, &search);
1505     while (entryPtr != NULL) {
1506     cmdName = Tcl_GetHashKey(&nsPtr->cmdTable, entryPtr);
1507     if ((simplePattern == NULL)
1508     || Tcl_StringMatch(cmdName, simplePattern)) {
1509     cmdPtr = (Command *) Tcl_GetHashValue(entryPtr);
1510    
1511     if (specificNsInPattern) {
1512     elemObjPtr = Tcl_NewObj();
1513     Tcl_GetCommandFullName(interp, (Tcl_Command) cmdPtr,
1514     elemObjPtr);
1515     } else {
1516     elemObjPtr = Tcl_NewStringObj(cmdName, -1);
1517     }
1518    
1519     realCmdPtr = (Command *)
1520     TclGetOriginalCommand((Tcl_Command) cmdPtr);
1521    
1522     if (TclIsProc(cmdPtr)
1523     || ((realCmdPtr != NULL) && TclIsProc(realCmdPtr))) {
1524     Tcl_ListObjAppendElement(interp, listPtr, elemObjPtr);
1525     }
1526     }
1527     entryPtr = Tcl_NextHashEntry(&search);
1528     }
1529    
1530     /*
1531     * If the effective namespace isn't the global :: namespace, and a
1532     * specific namespace wasn't requested in the pattern, then add in
1533     * all global :: procs that match the simple pattern. Of course,
1534     * we add in only those procs that aren't hidden by a proc in
1535     * the effective namespace.
1536     */
1537    
1538     #ifdef INFO_PROCS_SEARCH_GLOBAL_NS
1539     /*
1540     * If "info procs" worked like "info commands", returning the
1541     * commands also seen in the global namespace, then you would
1542     * include this code. As this could break backwards compatibilty
1543     * with 8.0-8.2, we decided not to "fix" it in 8.3, leaving the
1544     * behavior slightly different.
1545     */
1546     if ((nsPtr != globalNsPtr) && !specificNsInPattern) {
1547     entryPtr = Tcl_FirstHashEntry(&globalNsPtr->cmdTable, &search);
1548     while (entryPtr != NULL) {
1549     cmdName = Tcl_GetHashKey(&globalNsPtr->cmdTable, entryPtr);
1550     if ((simplePattern == NULL)
1551     || Tcl_StringMatch(cmdName, simplePattern)) {
1552     if (Tcl_FindHashEntry(&nsPtr->cmdTable, cmdName) == NULL) {
1553     cmdPtr = (Command *) Tcl_GetHashValue(entryPtr);
1554     realCmdPtr = (Command *) TclGetOriginalCommand(
1555     (Tcl_Command) cmdPtr);
1556    
1557     if (TclIsProc(cmdPtr) || ((realCmdPtr != NULL)
1558     && TclIsProc(realCmdPtr))) {
1559     Tcl_ListObjAppendElement(interp, listPtr,
1560     Tcl_NewStringObj(cmdName, -1));
1561     }
1562     }
1563     }
1564     entryPtr = Tcl_NextHashEntry(&search);
1565     }
1566     }
1567     #endif
1568     }
1569    
1570     Tcl_SetObjResult(interp, listPtr);
1571     return TCL_OK;
1572     }
1573    
1574     /*
1575     *----------------------------------------------------------------------
1576     *
1577     * InfoScriptCmd --
1578     *
1579     * Called to implement the "info script" command that returns the
1580     * script file that is currently being evaluated. Handles the
1581     * following syntax:
1582     *
1583     * info script
1584     *
1585     * Results:
1586     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1587     *
1588     * Side effects:
1589     * Returns a result in the interpreter's result object. If there is
1590     * an error, the result is an error message.
1591     *
1592     *----------------------------------------------------------------------
1593     */
1594    
1595     static int
1596     InfoScriptCmd(dummy, interp, objc, objv)
1597     ClientData dummy; /* Not used. */
1598     Tcl_Interp *interp; /* Current interpreter. */
1599     int objc; /* Number of arguments. */
1600     Tcl_Obj *CONST objv[]; /* Argument objects. */
1601     {
1602     Interp *iPtr = (Interp *) interp;
1603     if (objc != 2) {
1604     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1605     return TCL_ERROR;
1606     }
1607    
1608     if (iPtr->scriptFile != NULL) {
1609     Tcl_SetStringObj(Tcl_GetObjResult(interp), iPtr->scriptFile, -1);
1610     }
1611     return TCL_OK;
1612     }
1613    
1614     /*
1615     *----------------------------------------------------------------------
1616     *
1617     * InfoSharedlibCmd --
1618     *
1619     * Called to implement the "info sharedlibextension" command that
1620     * returns the file extension used for shared libraries. Handles the
1621     * following syntax:
1622     *
1623     * info sharedlibextension
1624     *
1625     * Results:
1626     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1627     *
1628     * Side effects:
1629     * Returns a result in the interpreter's result object. If there is
1630     * an error, the result is an error message.
1631     *
1632     *----------------------------------------------------------------------
1633     */
1634    
1635     static int
1636     InfoSharedlibCmd(dummy, interp, objc, objv)
1637     ClientData dummy; /* Not used. */
1638     Tcl_Interp *interp; /* Current interpreter. */
1639     int objc; /* Number of arguments. */
1640     Tcl_Obj *CONST objv[]; /* Argument objects. */
1641     {
1642     if (objc != 2) {
1643     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1644     return TCL_ERROR;
1645     }
1646    
1647     #ifdef TCL_SHLIB_EXT
1648     Tcl_SetStringObj(Tcl_GetObjResult(interp), TCL_SHLIB_EXT, -1);
1649     #endif
1650     return TCL_OK;
1651     }
1652    
1653     /*
1654     *----------------------------------------------------------------------
1655     *
1656     * InfoTclVersionCmd --
1657     *
1658     * Called to implement the "info tclversion" command that returns the
1659     * version number for this Tcl library. Handles the following syntax:
1660     *
1661     * info tclversion
1662     *
1663     * Results:
1664     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1665     *
1666     * Side effects:
1667     * Returns a result in the interpreter's result object. If there is
1668     * an error, the result is an error message.
1669     *
1670     *----------------------------------------------------------------------
1671     */
1672    
1673     static int
1674     InfoTclVersionCmd(dummy, interp, objc, objv)
1675     ClientData dummy; /* Not used. */
1676     Tcl_Interp *interp; /* Current interpreter. */
1677     int objc; /* Number of arguments. */
1678     Tcl_Obj *CONST objv[]; /* Argument objects. */
1679     {
1680     char *version;
1681    
1682     if (objc != 2) {
1683     Tcl_WrongNumArgs(interp, 2, objv, NULL);
1684     return TCL_ERROR;
1685     }
1686    
1687     version = Tcl_GetVar(interp, "tcl_version",
1688     (TCL_GLOBAL_ONLY | TCL_LEAVE_ERR_MSG));
1689     if (version != NULL) {
1690     Tcl_SetStringObj(Tcl_GetObjResult(interp), version, -1);
1691     return TCL_OK;
1692     }
1693     return TCL_ERROR;
1694     }
1695    
1696     /*
1697     *----------------------------------------------------------------------
1698     *
1699     * InfoVarsCmd --
1700     *
1701     * Called to implement the "info vars" command that returns the
1702     * list of variables in the interpreter that match an optional pattern.
1703     * The pattern, if any, consists of an optional sequence of namespace
1704     * names separated by "::" qualifiers, which is followed by a
1705     * glob-style pattern that restricts which variables are returned.
1706     * Handles the following syntax:
1707     *
1708     * info vars ?pattern?
1709     *
1710     * Results:
1711     * Returns TCL_OK if successful and TCL_ERROR if there is an error.
1712     *
1713     * Side effects:
1714     * Returns a result in the interpreter's result object. If there is
1715     * an error, the result is an error message.
1716     *
1717     *----------------------------------------------------------------------
1718     */
1719    
1720     static int
1721     InfoVarsCmd(dummy, interp, objc, objv)
1722     ClientData dummy; /* Not used. */
1723     Tcl_Interp *interp; /* Current interpreter. */
1724     int objc; /* Number of arguments. */
1725     Tcl_Obj *CONST objv[]; /* Argument objects. */
1726     {
1727     Interp *iPtr = (Interp *) interp;
1728     char *varName, *pattern, *simplePattern;
1729     register Tcl_HashEntry *entryPtr;
1730     Tcl_HashSearch search;
1731     Var *varPtr;
1732     Namespace *nsPtr;
1733     Namespace *globalNsPtr = (Namespace *) Tcl_GetGlobalNamespace(interp);
1734     Namespace *currNsPtr = (Namespace *) Tcl_GetCurrentNamespace(interp);
1735     Tcl_Obj *listPtr, *elemObjPtr;
1736     int specificNsInPattern = 0; /* Init. to avoid compiler warning. */
1737    
1738     /*
1739     * Get the pattern and find the "effective namespace" in which to
1740     * list variables. We only use this effective namespace if there's
1741     * no active Tcl procedure frame.
1742     */
1743    
1744     if (objc == 2) {
1745     simplePattern = NULL;
1746     nsPtr = currNsPtr;
1747     specificNsInPattern = 0;
1748     } else if (objc == 3) {
1749     /*
1750     * From the pattern, get the effective namespace and the simple
1751     * pattern (no namespace qualifiers or ::'s) at the end. If an
1752     * error was found while parsing the pattern, return it. Otherwise,
1753     * if the namespace wasn't found, just leave nsPtr NULL: we will
1754     * return an empty list since no variables there can be found.
1755     */
1756    
1757     Namespace *dummy1NsPtr, *dummy2NsPtr;
1758    
1759     pattern = Tcl_GetString(objv[2]);
1760     TclGetNamespaceForQualName(interp, pattern, (Namespace *) NULL,
1761     /*flags*/ 0, &nsPtr, &dummy1NsPtr, &dummy2NsPtr,
1762     &simplePattern);
1763    
1764     if (nsPtr != NULL) { /* we successfully found the pattern's ns */
1765     specificNsInPattern = (strcmp(simplePattern, pattern) != 0);
1766     }
1767     } else {
1768     Tcl_WrongNumArgs(interp, 2, objv, "?pattern?");
1769     return TCL_ERROR;
1770     }
1771    
1772     /*
1773     * If the namespace specified in the pattern wasn't found, just return.
1774     */
1775    
1776     if (nsPtr == NULL) {
1777     return TCL_OK;
1778     }
1779    
1780     listPtr = Tcl_NewListObj(0, (Tcl_Obj **) NULL);
1781    
1782     if ((iPtr->varFramePtr == NULL)
1783     || !iPtr->varFramePtr->isProcCallFrame
1784     || specificNsInPattern) {
1785     /*
1786     * There is no frame pointer, the frame pointer was pushed only
1787     * to activate a namespace, or we are in a procedure call frame
1788     * but a specific namespace was specified. Create a list containing
1789     * only the variables in the effective namespace's variable table.
1790     */
1791    
1792     entryPtr = Tcl_FirstHashEntry(&nsPtr->varTable, &search);
1793     while (entryPtr != NULL) {
1794     varPtr = (Var *) Tcl_GetHashValue(entryPtr);
1795     if (!TclIsVarUndefined(varPtr)
1796     || (varPtr->flags & VAR_NAMESPACE_VAR)) {
1797     varName = Tcl_GetHashKey(&nsPtr->varTable, entryPtr);
1798     if ((simplePattern == NULL)
1799     || Tcl_StringMatch(varName, simplePattern)) {
1800     if (specificNsInPattern) {
1801     elemObjPtr = Tcl_NewObj();
1802     Tcl_GetVariableFullName(interp, (Tcl_Var) varPtr,
1803     elemObjPtr);
1804     } else {
1805     elemObjPtr = Tcl_NewStringObj(varName, -1);
1806     }
1807     Tcl_ListObjAppendElement(interp, listPtr, elemObjPtr);
1808     }
1809     }
1810     entryPtr = Tcl_NextHashEntry(&search);
1811     }
1812    
1813     /*
1814     * If the effective namespace isn't the global :: namespace, and a
1815     * specific namespace wasn't requested in the pattern (i.e., the
1816     * pattern only specifies variable names), then add in all global ::
1817     * variables that match the simple pattern. Of course, add in only
1818     * those variables that aren't hidden by a variable in the effective
1819     * namespace.
1820     */
1821    
1822     if ((nsPtr != globalNsPtr) && !specificNsInPattern) {
1823     entryPtr = Tcl_FirstHashEntry(&globalNsPtr->varTable, &search);
1824     while (entryPtr != NULL) {
1825     varPtr = (Var *) Tcl_GetHashValue(entryPtr);
1826     if (!TclIsVarUndefined(varPtr)
1827     || (varPtr->flags & VAR_NAMESPACE_VAR)) {
1828     varName = Tcl_GetHashKey(&globalNsPtr->varTable,
1829     entryPtr);
1830     if ((simplePattern == NULL)
1831     || Tcl_StringMatch(varName, simplePattern)) {
1832     if (Tcl_FindHashEntry(&nsPtr->varTable, varName) == NULL) {
1833     Tcl_ListObjAppendElement(interp, listPtr,
1834     Tcl_NewStringObj(varName, -1));
1835     }
1836     }
1837     }
1838     entryPtr = Tcl_NextHashEntry(&search);
1839     }
1840     }
1841     } else if (((Interp *)interp)->varFramePtr->procPtr != NULL) {
1842     AppendLocals(interp, listPtr, simplePattern, 1);
1843     }
1844    
1845     Tcl_SetObjResult(interp, listPtr);
1846     return TCL_OK;
1847     }
1848    
1849     /*
1850     *----------------------------------------------------------------------
1851     *
1852     * Tcl_JoinObjCmd --
1853     *
1854     * This procedure is invoked to process the "join" Tcl command.
1855     * See the user documentation for details on what it does.
1856     *
1857     * Results:
1858     * A standard Tcl object result.
1859     *
1860     * Side effects:
1861     * See the user documentation.
1862     *
1863     *----------------------------------------------------------------------
1864     */
1865    
1866     /* ARGSUSED */
1867     int
1868     Tcl_JoinObjCmd(dummy, interp, objc, objv)
1869     ClientData dummy; /* Not used. */
1870     Tcl_Interp *interp; /* Current interpreter. */
1871     int objc; /* Number of arguments. */
1872     Tcl_Obj *CONST objv[]; /* The argument objects. */
1873     {
1874     char *joinString, *bytes;
1875     int joinLength, listLen, length, i, result;
1876     Tcl_Obj **elemPtrs;
1877     Tcl_Obj *resObjPtr;
1878    
1879     if (objc == 2) {
1880     joinString = " ";
1881     joinLength = 1;
1882     } else if (objc == 3) {
1883     joinString = Tcl_GetStringFromObj(objv[2], &joinLength);
1884     } else {
1885     Tcl_WrongNumArgs(interp, 1, objv, "list ?joinString?");
1886     return TCL_ERROR;
1887     }
1888    
1889     /*
1890     * Make sure the list argument is a list object and get its length and
1891     * a pointer to its array of element pointers.
1892     */
1893    
1894     result = Tcl_ListObjGetElements(interp, objv[1], &listLen, &elemPtrs);
1895     if (result != TCL_OK) {
1896     return result;
1897     }
1898    
1899     /*
1900     * Now concatenate strings to form the "joined" result. We append
1901     * directly into the interpreter's result object.
1902     */
1903    
1904     resObjPtr = Tcl_GetObjResult(interp);
1905    
1906     for (i = 0; i < listLen; i++) {
1907     bytes = Tcl_GetStringFromObj(elemPtrs[i], &length);
1908     if (i > 0) {
1909     Tcl_AppendToObj(resObjPtr, joinString, joinLength);
1910     }
1911     Tcl_AppendToObj(resObjPtr, bytes, length);
1912     }
1913     return TCL_OK;
1914     }
1915    
1916     /*
1917     *----------------------------------------------------------------------
1918     *
1919     * Tcl_LindexObjCmd --
1920     *
1921     * This object-based procedure is invoked to process the "lindex" Tcl
1922     * command. See the user documentation for details on what it does.
1923     *
1924     * Results:
1925     * A standard Tcl object result.
1926     *
1927     * Side effects:
1928     * See the user documentation.
1929     *
1930     *----------------------------------------------------------------------
1931     */
1932    
1933     /* ARGSUSED */
1934     int
1935     Tcl_LindexObjCmd(dummy, interp, objc, objv)
1936     ClientData dummy; /* Not used. */
1937     Tcl_Interp *interp; /* Current interpreter. */
1938     int objc; /* Number of arguments. */
1939     Tcl_Obj *CONST objv[]; /* Argument objects. */
1940     {
1941     Tcl_Obj *listPtr;
1942     Tcl_Obj **elemPtrs;
1943     int listLen, index, result;
1944    
1945     if (objc != 3) {
1946     Tcl_WrongNumArgs(interp, 1, objv, "list index");
1947     return TCL_ERROR;
1948     }
1949    
1950     /*
1951     * Convert the first argument to a list if necessary.
1952     */
1953    
1954     listPtr = objv[1];
1955     result = Tcl_ListObjGetElements(interp, listPtr, &listLen, &elemPtrs);
1956     if (result != TCL_OK) {
1957     return result;
1958     }
1959    
1960     /*
1961     * Get the index from objv[2].
1962     */
1963    
1964     result = TclGetIntForIndex(interp, objv[2], /*endValue*/ (listLen - 1),
1965     &index);
1966     if (result != TCL_OK) {
1967     return result;
1968     }
1969     if ((index < 0) || (index >= listLen)) {
1970     /*
1971     * The index is out of range: the result is an empty string object.
1972     */
1973    
1974     return TCL_OK;
1975     }
1976    
1977     /*
1978     * Make sure listPtr still refers to a list object. It might have been
1979     * converted to an int above if the argument objects were shared.
1980     */
1981    
1982     if (listPtr->typePtr != &tclListType) {
1983     result = Tcl_ListObjGetElements(interp, listPtr, &listLen,
1984     &elemPtrs);
1985     if (result != TCL_OK) {
1986     return result;
1987     }
1988     }
1989    
1990     /*
1991     * Set the interpreter's object result to the index-th list element.
1992     */
1993    
1994     Tcl_SetObjResult(interp, elemPtrs[index]);
1995     return TCL_OK;
1996     }
1997    
1998     /*
1999     *----------------------------------------------------------------------
2000     *
2001     * Tcl_LinsertObjCmd --
2002     *
2003     * This object-based procedure is invoked to process the "linsert" Tcl
2004     * command. See the user documentation for details on what it does.
2005     *
2006     * Results:
2007     * A new Tcl list object formed by inserting zero or more elements
2008     * into a list.
2009     *
2010     * Side effects:
2011     * See the user documentation.
2012     *
2013     *----------------------------------------------------------------------
2014     */
2015    
2016     /* ARGSUSED */
2017     int
2018     Tcl_LinsertObjCmd(dummy, interp, objc, objv)
2019     ClientData dummy; /* Not used. */
2020     Tcl_Interp *interp; /* Current interpreter. */
2021     register int objc; /* Number of arguments. */
2022     Tcl_Obj *CONST objv[]; /* Argument objects. */
2023     {
2024     Tcl_Obj *listPtr, *resultPtr;
2025     Tcl_ObjType *typePtr;
2026     int index, isDuplicate, len, result;
2027    
2028     if (objc < 4) {
2029     Tcl_WrongNumArgs(interp, 1, objv, "list index element ?element ...?");
2030     return TCL_ERROR;
2031     }
2032    
2033     /*
2034     * Get the index first since, if a conversion to int is needed, it
2035     * will invalidate the list's internal representation.
2036     */
2037    
2038     result = Tcl_ListObjLength(interp, objv[1], &len);
2039     if (result != TCL_OK) {
2040     return result;
2041     }
2042    
2043     result = TclGetIntForIndex(interp, objv[2], /*endValue*/ len, &index);
2044     if (result != TCL_OK) {
2045     return result;
2046     }
2047    
2048     /*
2049     * If the list object is unshared we can modify it directly. Otherwise
2050     * we create a copy to modify: this is "copy on write". We create the
2051     * duplicate directly in the interpreter's object result.
2052     */
2053    
2054     listPtr = objv[1];
2055     isDuplicate = 0;
2056     if (Tcl_IsShared(listPtr)) {
2057     /*
2058     * The following code must reflect the logic in Tcl_DuplicateObj()
2059     * except that it must duplicate the list object directly into the
2060     * interpreter's result.
2061     */
2062    
2063     Tcl_ResetResult(interp);
2064     resultPtr = Tcl_GetObjResult(interp);
2065     typePtr = listPtr->typePtr;
2066     if (listPtr->bytes == NULL) {
2067     resultPtr->bytes = NULL;
2068     } else if (listPtr->bytes != tclEmptyStringRep) {
2069     len = listPtr->length;
2070     TclInitStringRep(resultPtr, listPtr->bytes, len);
2071     }
2072     if (typePtr != NULL) {
2073     if (typePtr->dupIntRepProc == NULL) {
2074     resultPtr->internalRep = listPtr->internalRep;
2075     resultPtr->typePtr = typePtr;
2076     } else {
2077     (*typePtr->dupIntRepProc)(listPtr, resultPtr);
2078     }
2079     }
2080     listPtr = resultPtr;
2081     isDuplicate = 1;
2082     }
2083    
2084     if ((objc == 4) && (index == INT_MAX)) {
2085     /*
2086     * Special case: insert one element at the end of the list.
2087     */
2088    
2089     result = Tcl_ListObjAppendElement(interp, listPtr, objv[3]);
2090     } else if (objc > 3) {
2091     result = Tcl_ListObjReplace(interp, listPtr, index, 0,
2092     (objc-3), &(objv[3]));
2093     }
2094     if (result != TCL_OK) {
2095     return result;
2096     }
2097    
2098     /*
2099     * Set the interpreter's object result.
2100     */
2101    
2102     if (!isDuplicate) {
2103     Tcl_SetObjResult(interp, listPtr);
2104     }
2105     return TCL_OK;
2106     }
2107    
2108     /*
2109     *----------------------------------------------------------------------
2110     *
2111     * Tcl_ListObjCmd --
2112     *
2113     * This procedure is invoked to process the "list" Tcl command.
2114     * See the user documentation for details on what it does.
2115     *
2116     * Results:
2117     * A standard Tcl object result.
2118     *
2119     * Side effects:
2120     * See the user documentation.
2121     *
2122     *----------------------------------------------------------------------
2123     */
2124    
2125     /* ARGSUSED */
2126     int
2127     Tcl_ListObjCmd(dummy, interp, objc, objv)
2128     ClientData dummy; /* Not used. */
2129     Tcl_Interp *interp; /* Current interpreter. */
2130     register int objc; /* Number of arguments. */
2131     register Tcl_Obj *CONST objv[]; /* The argument objects. */
2132     {
2133     /*
2134     * If there are no list elements, the result is an empty object.
2135     * Otherwise modify the interpreter's result object to be a list object.
2136     */
2137    
2138     if (objc > 1) {
2139     Tcl_SetListObj(Tcl_GetObjResult(interp), (objc-1), &(objv[1]));
2140     }
2141     return TCL_OK;
2142     }
2143    
2144     /*
2145     *----------------------------------------------------------------------
2146     *
2147     * Tcl_LlengthObjCmd --
2148     *
2149     * This object-based procedure is invoked to process the "llength" Tcl
2150     * command. See the user documentation for details on what it does.
2151     *
2152     * Results:
2153     * A standard Tcl object result.
2154     *
2155     * Side effects:
2156     * See the user documentation.
2157     *
2158     *----------------------------------------------------------------------
2159     */
2160    
2161     /* ARGSUSED */
2162     int
2163     Tcl_LlengthObjCmd(dummy, interp, objc, objv)
2164     ClientData dummy; /* Not used. */
2165     Tcl_Interp *interp; /* Current interpreter. */
2166     int objc; /* Number of arguments. */
2167     register Tcl_Obj *CONST objv[]; /* Argument objects. */
2168     {
2169     int listLen, result;
2170    
2171     if (objc != 2) {
2172     Tcl_WrongNumArgs(interp, 1, objv, "list");
2173     return TCL_ERROR;
2174     }
2175    
2176     result = Tcl_ListObjLength(interp, objv[1], &listLen);
2177     if (result != TCL_OK) {
2178     return result;
2179     }
2180    
2181     /*
2182     * Set the interpreter's object result to an integer object holding the
2183     * length.
2184     */
2185    
2186     Tcl_SetIntObj(Tcl_GetObjResult(interp), listLen);
2187     return TCL_OK;
2188     }
2189    
2190     /*
2191     *----------------------------------------------------------------------
2192     *
2193     * Tcl_LrangeObjCmd --
2194     *
2195     * This procedure is invoked to process the "lrange" Tcl command.
2196     * See the user documentation for details on what it does.
2197     *
2198     * Results:
2199     * A standard Tcl object result.
2200     *
2201     * Side effects:
2202     * See the user documentation.
2203     *
2204     *----------------------------------------------------------------------
2205     */
2206    
2207     /* ARGSUSED */
2208     int
2209     Tcl_LrangeObjCmd(notUsed, interp, objc, objv)
2210     ClientData notUsed; /* Not used. */
2211     Tcl_Interp *interp; /* Current interpreter. */
2212     int objc; /* Number of arguments. */
2213     register Tcl_Obj *CONST objv[]; /* Argument objects. */
2214     {
2215     Tcl_Obj *listPtr;
2216     Tcl_Obj **elemPtrs;
2217     int listLen, first, last, numElems, result;
2218    
2219     if (objc != 4) {
2220     Tcl_WrongNumArgs(interp, 1, objv, "list first last");
2221     return TCL_ERROR;
2222     }
2223    
2224     /*
2225     * Make sure the list argument is a list object and get its length and
2226     * a pointer to its array of element pointers.
2227     */
2228    
2229     listPtr = objv[1];
2230     result = Tcl_ListObjGetElements(interp, listPtr, &listLen, &elemPtrs);
2231     if (result != TCL_OK) {
2232     return result;
2233     }
2234    
2235     /*
2236     * Get the first and last indexes.
2237     */
2238    
2239     result = TclGetIntForIndex(interp, objv[2], /*endValue*/ (listLen - 1),
2240     &first);
2241     if (result != TCL_OK) {
2242     return result;
2243     }
2244     if (first < 0) {
2245     first = 0;
2246     }
2247    
2248     result = TclGetIntForIndex(interp, objv[3], /*endValue*/ (listLen - 1),
2249     &last);
2250     if (result != TCL_OK) {
2251     return result;
2252     }
2253     if (last >= listLen) {
2254     last = (listLen - 1);
2255     }
2256    
2257     if (first > last) {
2258     return TCL_OK; /* the result is an empty object */
2259     }
2260    
2261     /*
2262     * Make sure listPtr still refers to a list object. It might have been
2263     * converted to an int above if the argument objects were shared.
2264     */
2265    
2266     if (listPtr->typePtr != &tclListType) {
2267     result = Tcl_ListObjGetElements(interp, listPtr, &listLen,
2268     &elemPtrs);
2269     if (result != TCL_OK) {
2270     return result;
2271     }
2272     }
2273    
2274     /*
2275     * Extract a range of fields. We modify the interpreter's result object
2276     * to be a list object containing the specified elements.
2277     */
2278    
2279     numElems = (last - first + 1);
2280     Tcl_SetListObj(Tcl_GetObjResult(interp), numElems, &(elemPtrs[first]));
2281     return TCL_OK;
2282     }
2283    
2284     /*
2285     *----------------------------------------------------------------------
2286     *
2287     * Tcl_LreplaceObjCmd --
2288     *
2289     * This object-based procedure is invoked to process the "lreplace"
2290     * Tcl command. See the user documentation for details on what it does.
2291     *
2292     * Results:
2293     * A new Tcl list object formed by replacing zero or more elements of
2294     * a list.
2295     *
2296     * Side effects:
2297     * See the user documentation.
2298     *
2299     *----------------------------------------------------------------------
2300     */
2301    
2302     /* ARGSUSED */
2303     int
2304     Tcl_LreplaceObjCmd(dummy, interp, objc, objv)
2305     ClientData dummy; /* Not used. */
2306     Tcl_Interp *interp; /* Current interpreter. */
2307     int objc; /* Number of arguments. */
2308     Tcl_Obj *CONST objv[]; /* Argument objects. */
2309     {
2310     register Tcl_Obj *listPtr;
2311     int createdNewObj, first, last, listLen, numToDelete;
2312     int firstArgLen, result;
2313     char *firstArg;
2314    
2315     if (objc < 4) {
2316     Tcl_WrongNumArgs(interp, 1, objv,
2317     "list first last ?element element ...?");
2318     return TCL_ERROR;
2319     }
2320    
2321     /*
2322     * If the list object is unshared we can modify it directly, otherwise
2323     * we create a copy to modify: this is "copy on write".
2324     */
2325    
2326     listPtr = objv[1];
2327     createdNewObj = 0;
2328     if (Tcl_IsShared(listPtr)) {
2329     listPtr = Tcl_DuplicateObj(listPtr);
2330     createdNewObj = 1;
2331     }
2332     result = Tcl_ListObjLength(interp, listPtr, &listLen);
2333     if (result != TCL_OK) {
2334     errorReturn:
2335     if (createdNewObj) {
2336     Tcl_DecrRefCount(listPtr); /* free unneeded obj */
2337     }
2338     return result;
2339     }
2340    
2341     /*
2342     * Get the first and last indexes.
2343     */
2344    
2345     result = TclGetIntForIndex(interp, objv[2], /*endValue*/ (listLen - 1),
2346     &first);
2347     if (result != TCL_OK) {
2348     goto errorReturn;
2349     }
2350     firstArg = Tcl_GetStringFromObj(objv[2], &firstArgLen);
2351    
2352     result = TclGetIntForIndex(interp, objv[3], /*endValue*/ (listLen - 1),
2353     &last);
2354     if (result != TCL_OK) {
2355     goto errorReturn;
2356     }
2357    
2358     if (first < 0) {
2359     first = 0;
2360     }
2361     if ((first >= listLen) && (listLen > 0)
2362     && (strncmp(firstArg, "end", (unsigned) firstArgLen) != 0)) {
2363     Tcl_AppendStringsToObj(Tcl_GetObjResult(interp),
2364     "list doesn't contain element ",
2365     Tcl_GetString(objv[2]), (int *) NULL);
2366     result = TCL_ERROR;
2367     goto errorReturn;
2368     }
2369     if (last >= listLen) {
2370     last = (listLen - 1);
2371     }
2372     if (first <= last) {
2373     numToDelete = (last - first + 1);
2374     } else {
2375     numToDelete = 0;
2376     }
2377    
2378     if (objc > 4) {
2379     result = Tcl_ListObjReplace(interp, listPtr, first, numToDelete,
2380     (objc-4), &(objv[4]));
2381     } else {
2382     result = Tcl_ListObjReplace(interp, listPtr, first, numToDelete,
2383     0, NULL);
2384     }
2385     if (result != TCL_OK) {
2386     goto errorReturn;
2387     }
2388    
2389     /*
2390     * Set the interpreter's object result.
2391     */
2392    
2393     Tcl_SetObjResult(interp, listPtr);
2394     return TCL_OK;
2395     }
2396    
2397     /*
2398     *----------------------------------------------------------------------
2399     *
2400     * Tcl_LsearchObjCmd --
2401     *
2402     * This procedure is invoked to process the "lsearch" Tcl command.
2403     * See the user documentation for details on what it does.
2404     *
2405     * Results:
2406     * A standard Tcl result.
2407     *
2408     * Side effects:
2409     * See the user documentation.
2410     *
2411     *----------------------------------------------------------------------
2412     */
2413    
2414     int
2415     Tcl_LsearchObjCmd(clientData, interp, objc, objv)
2416     ClientData clientData; /* Not used. */
2417     Tcl_Interp *interp; /* Current interpreter. */
2418     int objc; /* Number of arguments. */
2419     Tcl_Obj *CONST objv[]; /* Argument values. */
2420     {
2421     char *bytes, *patternBytes;
2422     int i, match, mode, index, result, listc, length, elemLen;
2423     Tcl_Obj *patObj, **listv;
2424     static char *options[] = {
2425     "-exact", "-glob", "-regexp", NULL
2426     };
2427     enum options {
2428     LSEARCH_EXACT, LSEARCH_GLOB, LSEARCH_REGEXP
2429     };
2430    
2431     mode = LSEARCH_GLOB;
2432     if (objc == 4) {
2433     if (Tcl_GetIndexFromObj(interp, objv[1], options, "search mode", 0,
2434     &mode) != TCL_OK) {
2435     return TCL_ERROR;
2436     }
2437     } else if (objc != 3) {
2438     Tcl_WrongNumArgs(interp, 1, objv, "?mode? list pattern");
2439     return TCL_ERROR;
2440     }
2441    
2442     /*
2443     * Make sure the list argument is a list object and get its length and
2444     * a pointer to its array of element pointers.
2445     */
2446    
2447     result = Tcl_ListObjGetElements(interp, objv[objc - 2], &listc, &listv);
2448     if (result != TCL_OK) {
2449     return result;
2450     }
2451    
2452     patObj = objv[objc - 1];
2453     patternBytes = Tcl_GetStringFromObj(patObj, &length);
2454    
2455     index = -1;
2456     for (i = 0; i < listc; i++) {
2457     match = 0;
2458     switch ((enum options) mode) {
2459     case LSEARCH_EXACT: {
2460     bytes = Tcl_GetStringFromObj(listv[i], &elemLen);
2461     if (length == elemLen) {
2462     match = (memcmp(bytes, patternBytes,
2463     (size_t) length) == 0);
2464     }
2465     break;
2466     }
2467     case LSEARCH_GLOB: {
2468     match = Tcl_StringMatch(Tcl_GetString(listv[i]), patternBytes);
2469     break;
2470     }
2471     case LSEARCH_REGEXP: {
2472     match = Tcl_RegExpMatchObj(interp, listv[i], patObj);
2473     if (match < 0) {
2474     return TCL_ERROR;
2475     }
2476     break;
2477     }
2478     }
2479     if (match != 0) {
2480     index = i;
2481     break;
2482     }
2483     }
2484     Tcl_SetIntObj(Tcl_GetObjResult(interp), index);
2485     return TCL_OK;
2486     }
2487    
2488     /*
2489     *----------------------------------------------------------------------
2490     *
2491     * Tcl_LsortObjCmd --
2492     *
2493     * This procedure is invoked to process the "lsort" Tcl command.
2494     * See the user documentation for details on what it does.
2495     *
2496     * Results:
2497     * A standard Tcl result.
2498     *
2499     * Side effects:
2500     * See the user documentation.
2501     *
2502     *----------------------------------------------------------------------
2503     */
2504    
2505     int
2506     Tcl_LsortObjCmd(clientData, interp, objc, objv)
2507     ClientData clientData; /* Not used. */
2508     Tcl_Interp *interp; /* Current interpreter. */
2509     int objc; /* Number of arguments. */
2510     Tcl_Obj *CONST objv[]; /* Argument values. */
2511     {
2512     int i, index, unique;
2513     Tcl_Obj *resultPtr;
2514     int length;
2515     Tcl_Obj *cmdPtr, **listObjPtrs;
2516     SortElement *elementArray;
2517     SortElement *elementPtr;
2518     SortInfo sortInfo; /* Information about this sort that
2519     * needs to be passed to the
2520     * comparison function */
2521     static char *switches[] = {
2522     "-ascii", "-command", "-decreasing", "-dictionary", "-increasing",
2523     "-index", "-integer", "-real", "-unique", (char *) NULL
2524     };
2525    
2526     resultPtr = Tcl_GetObjResult(interp);
2527     if (objc < 2) {
2528     Tcl_WrongNumArgs(interp, 1, objv, "?options? list");
2529     return TCL_ERROR;
2530     }
2531    
2532     /*
2533     * Parse arguments to set up the mode for the sort.
2534     */
2535    
2536     sortInfo.isIncreasing = 1;
2537     sortInfo.sortMode = SORTMODE_ASCII;
2538     sortInfo.index = -1;
2539     sortInfo.interp = interp;
2540     sortInfo.resultCode = TCL_OK;
2541     cmdPtr = NULL;
2542     unique = 0;
2543     for (i = 1; i < objc-1; i++) {
2544     if (Tcl_GetIndexFromObj(interp, objv[i], switches, "option", 0, &index)
2545     != TCL_OK) {
2546     return TCL_ERROR;
2547     }
2548     switch (index) {
2549     case 0: /* -ascii */
2550     sortInfo.sortMode = SORTMODE_ASCII;
2551     break;
2552     case 1: /* -command */
2553     if (i == (objc-2)) {
2554     Tcl_AppendToObj(resultPtr,
2555     "\"-command\" option must be followed by comparison command",
2556     -1);
2557     return TCL_ERROR;
2558     }
2559     sortInfo.sortMode = SORTMODE_COMMAND;
2560     cmdPtr = objv[i+1];
2561     i++;
2562     break;
2563     case 2: /* -decreasing */
2564     sortInfo.isIncreasing = 0;
2565     break;
2566     case 3: /* -dictionary */
2567     sortInfo.sortMode = SORTMODE_DICTIONARY;
2568     break;
2569     case 4: /* -increasing */
2570     sortInfo.isIncreasing = 1;
2571     break;
2572     case 5: /* -index */
2573     if (i == (objc-2)) {
2574     Tcl_AppendToObj(resultPtr,
2575     "\"-index\" option must be followed by list index",
2576     -1);
2577     return TCL_ERROR;
2578     }
2579     if (TclGetIntForIndex(interp, objv[i+1], -2, &sortInfo.index)
2580     != TCL_OK) {
2581     return TCL_ERROR;
2582     }
2583     cmdPtr = objv[i+1];
2584     i++;
2585     break;
2586     case 6: /* -integer */
2587     sortInfo.sortMode = SORTMODE_INTEGER;
2588     break;
2589     case 7: /* -real */
2590     sortInfo.sortMode = SORTMODE_REAL;
2591     break;
2592     case 8: /* -unique */
2593     unique = 1;
2594     break;
2595     }
2596     }
2597     if (sortInfo.sortMode == SORTMODE_COMMAND) {
2598     /*
2599     * The existing command is a list. We want to flatten it, append
2600     * two dummy arguments on the end, and replace these arguments
2601     * later.
2602     */
2603    
2604     Tcl_Obj *newCommandPtr = Tcl_DuplicateObj(cmdPtr);
2605     Tcl_Obj *newObjPtr = Tcl_NewObj();
2606    
2607     Tcl_IncrRefCount(newCommandPtr);
2608     if (Tcl_ListObjAppendElement(interp, newCommandPtr, newObjPtr)
2609     != TCL_OK) {
2610     Tcl_DecrRefCount(newCommandPtr);
2611     Tcl_IncrRefCount(newObjPtr);
2612     Tcl_DecrRefCount(newObjPtr);
2613     return TCL_ERROR;
2614     }
2615     Tcl_ListObjAppendElement(interp, newCommandPtr, Tcl_NewObj());
2616     sortInfo.compareCmdPtr = newCommandPtr;
2617     }
2618    
2619     sortInfo.resultCode = Tcl_ListObjGetElements(interp, objv[objc-1],
2620     &length, &listObjPtrs);
2621     if (sortInfo.resultCode != TCL_OK) {
2622     goto done;
2623     }
2624     if (length <= 0) {
2625     return TCL_OK;
2626     }
2627     elementArray = (SortElement *) ckalloc(length * sizeof(SortElement));
2628     for (i=0; i < length; i++){
2629     elementArray[i].objPtr = listObjPtrs[i];
2630     elementArray[i].count = 0;
2631     elementArray[i].nextPtr = &elementArray[i+1];
2632     }
2633     elementArray[length-1].nextPtr = NULL;
2634     elementPtr = MergeSort(elementArray, &sortInfo);
2635     if (sortInfo.resultCode == TCL_OK) {
2636     /*
2637     * Note: must clear the interpreter's result object: it could
2638     * have been set by the -command script.
2639     */
2640    
2641     Tcl_ResetResult(interp);
2642     resultPtr = Tcl_GetObjResult(interp);
2643     if (unique) {
2644     for (; elementPtr != NULL; elementPtr = elementPtr->nextPtr){
2645     if (elementPtr->count == 0) {
2646     Tcl_ListObjAppendElement(interp, resultPtr,
2647     elementPtr->objPtr);
2648     }
2649     }
2650     } else {
2651     for (; elementPtr != NULL; elementPtr = elementPtr->nextPtr){
2652     Tcl_ListObjAppendElement(interp, resultPtr,
2653     elementPtr->objPtr);
2654     }
2655     }
2656     }
2657     ckfree((char*) elementArray);
2658    
2659     done:
2660     if (sortInfo.sortMode == SORTMODE_COMMAND) {
2661     Tcl_DecrRefCount(sortInfo.compareCmdPtr);
2662     sortInfo.compareCmdPtr = NULL;
2663     }
2664     return sortInfo.resultCode;
2665     }
2666    
2667     /*
2668     *----------------------------------------------------------------------
2669     *
2670     * MergeSort -
2671     *
2672     * This procedure sorts a linked list of SortElement structures
2673     * use the merge-sort algorithm.
2674     *
2675     * Results:
2676     * A pointer to the head of the list after sorting is returned.
2677     *
2678     * Side effects:
2679     * None, unless a user-defined comparison command does something
2680     * weird.
2681     *
2682     *----------------------------------------------------------------------
2683     */
2684    
2685     static SortElement *
2686     MergeSort(headPtr, infoPtr)
2687     SortElement *headPtr; /* First element on the list */
2688     SortInfo *infoPtr; /* Information needed by the
2689     * comparison operator */
2690     {
2691     /*
2692     * The subList array below holds pointers to temporary lists built
2693     * during the merge sort. Element i of the array holds a list of
2694     * length 2**i.
2695     */
2696    
2697     # define NUM_LISTS 30
2698     SortElement *subList[NUM_LISTS];
2699     SortElement *elementPtr;
2700     int i;
2701    
2702     for(i = 0; i < NUM_LISTS; i++){
2703     subList[i] = NULL;
2704     }
2705     while (headPtr != NULL) {
2706     elementPtr = headPtr;
2707     headPtr = headPtr->nextPtr;
2708     elementPtr->nextPtr = 0;
2709     for (i = 0; (i < NUM_LISTS) && (subList[i] != NULL); i++){
2710     elementPtr = MergeLists(subList[i], elementPtr, infoPtr);
2711     subList[i] = NULL;
2712     }
2713     if (i >= NUM_LISTS) {
2714     i = NUM_LISTS-1;
2715     }
2716     subList[i] = elementPtr;
2717     }
2718     elementPtr = NULL;
2719     for (i = 0; i < NUM_LISTS; i++){
2720     elementPtr = MergeLists(subList[i], elementPtr, infoPtr);
2721     }
2722     return elementPtr;
2723     }
2724    
2725     /*
2726     *----------------------------------------------------------------------
2727     *
2728     * MergeLists -
2729     *
2730     * This procedure combines two sorted lists of SortElement structures
2731     * into a single sorted list.
2732     *
2733     * Results:
2734     * The unified list of SortElement structures.
2735     *
2736     * Side effects:
2737     * None, unless a user-defined comparison command does something
2738     * weird.
2739     *
2740     *----------------------------------------------------------------------
2741     */
2742    
2743     static SortElement *
2744     MergeLists(leftPtr, rightPtr, infoPtr)
2745     SortElement *leftPtr; /* First list to be merged; may be
2746     * NULL. */
2747     SortElement *rightPtr; /* Second list to be merged; may be
2748     * NULL. */
2749     SortInfo *infoPtr; /* Information needed by the
2750     * comparison operator. */
2751     {
2752     SortElement *headPtr;
2753     SortElement *tailPtr;
2754     int cmp;
2755    
2756     if (leftPtr == NULL) {
2757     return rightPtr;
2758     }
2759     if (rightPtr == NULL) {
2760     return leftPtr;
2761     }
2762     cmp = SortCompare(leftPtr->objPtr, rightPtr->objPtr, infoPtr);
2763     if (cmp > 0) {
2764     tailPtr = rightPtr;
2765     rightPtr = rightPtr->nextPtr;
2766     } else {
2767     if (cmp == 0) {
2768     leftPtr->count++;
2769     }
2770     tailPtr = leftPtr;
2771     leftPtr = leftPtr->nextPtr;
2772     }
2773     headPtr = tailPtr;
2774     while ((leftPtr != NULL) && (rightPtr != NULL)) {
2775     cmp = SortCompare(leftPtr->objPtr, rightPtr->objPtr, infoPtr);
2776     if (cmp > 0) {
2777     tailPtr->nextPtr = rightPtr;
2778     tailPtr = rightPtr;
2779     rightPtr = rightPtr->nextPtr;
2780     } else {
2781     if (cmp == 0) {
2782     leftPtr->count++;
2783     }
2784     tailPtr->nextPtr = leftPtr;
2785     tailPtr = leftPtr;
2786     leftPtr = leftPtr->nextPtr;
2787     }
2788     }
2789     if (leftPtr != NULL) {
2790     tailPtr->nextPtr = leftPtr;
2791     } else {
2792     tailPtr->nextPtr = rightPtr;
2793     }
2794     return headPtr;
2795     }
2796    
2797     /*
2798     *----------------------------------------------------------------------
2799     *
2800     * SortCompare --
2801     *
2802     * This procedure is invoked by MergeLists to determine the proper
2803     * ordering between two elements.
2804     *
2805     * Results:
2806     * A negative results means the the first element comes before the
2807     * second, and a positive results means that the second element
2808     * should come first. A result of zero means the two elements
2809     * are equal and it doesn't matter which comes first.
2810     *
2811     * Side effects:
2812     * None, unless a user-defined comparison command does something
2813     * weird.
2814     *
2815     *----------------------------------------------------------------------
2816     */
2817    
2818     static int
2819     SortCompare(objPtr1, objPtr2, infoPtr)
2820     Tcl_Obj *objPtr1, *objPtr2; /* Values to be compared. */
2821     SortInfo *infoPtr; /* Information passed from the
2822     * top-level "lsort" command */
2823     {
2824     int order, listLen, index;
2825     Tcl_Obj *objPtr;
2826     char buffer[TCL_INTEGER_SPACE];
2827    
2828     order = 0;
2829     if (infoPtr->resultCode != TCL_OK) {
2830     /*
2831     * Once an error has occurred, skip any future comparisons
2832     * so as to preserve the error message in sortInterp->result.
2833     */
2834    
2835     return order;
2836     }
2837     if (infoPtr->index != -1) {
2838     /*
2839     * The "-index" option was specified. Treat each object as a
2840     * list, extract the requested element from each list, and
2841     * compare the elements, not the lists. The special index "end"
2842     * is signaled here with a large negative index.
2843     */
2844    
2845     if (Tcl_ListObjLength(infoPtr->interp, objPtr1, &listLen) != TCL_OK) {
2846     infoPtr->resultCode = TCL_ERROR;
2847     return order;
2848     }
2849     if (infoPtr->index < -1) {
2850     index = listLen - 1;
2851     } else {
2852     index = infoPtr->index;
2853     }
2854    
2855     if (Tcl_ListObjIndex(infoPtr->interp, objPtr1, index, &objPtr)
2856     != TCL_OK) {
2857     infoPtr->resultCode = TCL_ERROR;
2858     return order;
2859     }
2860     if (objPtr == NULL) {
2861     objPtr = objPtr1;
2862     missingElement:
2863     TclFormatInt(buffer, infoPtr->index);
2864     Tcl_AppendStringsToObj(Tcl_GetObjResult(infoPtr->interp),
2865     "element ", buffer, " missing from sublist \"",
2866     Tcl_GetString(objPtr), "\"", (char *) NULL);
2867     infoPtr->resultCode = TCL_ERROR;
2868     return order;
2869     }
2870     objPtr1 = objPtr;
2871    
2872     if (Tcl_ListObjLength(infoPtr->interp, objPtr2, &listLen) != TCL_OK) {
2873     infoPtr->resultCode = TCL_ERROR;
2874     return order;
2875     }
2876     if (infoPtr->index < -1) {
2877     index = listLen - 1;
2878     } else {
2879     index = infoPtr->index;
2880     }
2881    
2882     if (Tcl_ListObjIndex(infoPtr->interp, objPtr2, index, &objPtr)
2883     != TCL_OK) {
2884     infoPtr->resultCode = TCL_ERROR;
2885     return order;
2886     }
2887     if (objPtr == NULL) {
2888     objPtr = objPtr2;
2889     goto missingElement;
2890     }
2891     objPtr2 = objPtr;
2892     }
2893     if (infoPtr->sortMode == SORTMODE_ASCII) {
2894     order = strcmp(Tcl_GetString(objPtr1), Tcl_GetString(objPtr2));
2895     } else if (infoPtr->sortMode == SORTMODE_DICTIONARY) {
2896     order = DictionaryCompare(
2897     Tcl_GetString(objPtr1), Tcl_GetString(objPtr2));
2898     } else if (infoPtr->sortMode == SORTMODE_INTEGER) {
2899     long a, b;
2900    
2901     if ((Tcl_GetLongFromObj(infoPtr->interp, objPtr1, &a) != TCL_OK)
2902     || (Tcl_GetLongFromObj(infoPtr->interp, objPtr2, &b)
2903     != TCL_OK)) {
2904     infoPtr->resultCode = TCL_ERROR;
2905     return order;
2906     }
2907     if (a > b) {
2908     order = 1;
2909     } else if (b > a) {
2910     order = -1;
2911     }
2912     } else if (infoPtr->sortMode == SORTMODE_REAL) {
2913     double a, b;
2914    
2915     if ((Tcl_GetDoubleFromObj(infoPtr->interp, objPtr1, &a) != TCL_OK)
2916     || (Tcl_GetDoubleFromObj(infoPtr->interp, objPtr2, &b)
2917     != TCL_OK)) {
2918     infoPtr->resultCode = TCL_ERROR;
2919     return order;
2920     }
2921     if (a > b) {
2922     order = 1;
2923     } else if (b > a) {
2924     order = -1;
2925     }
2926     } else {
2927     Tcl_Obj **objv, *paramObjv[2];
2928     int objc;
2929    
2930     paramObjv[0] = objPtr1;
2931     paramObjv[1] = objPtr2;
2932    
2933     /*
2934     * We made space in the command list for the two things to
2935     * compare. Replace them and evaluate the result.
2936     */
2937    
2938     Tcl_ListObjLength(infoPtr->interp, infoPtr->compareCmdPtr, &objc);
2939     Tcl_ListObjReplace(infoPtr->interp, infoPtr->compareCmdPtr, objc - 2,
2940     2, 2, paramObjv);
2941     Tcl_ListObjGetElements(infoPtr->interp, infoPtr->compareCmdPtr,
2942     &objc, &objv);
2943    
2944     infoPtr->resultCode = Tcl_EvalObjv(infoPtr->interp, objc, objv, 0);
2945    
2946     if (infoPtr->resultCode != TCL_OK) {
2947     Tcl_AddErrorInfo(infoPtr->interp,
2948     "\n (-compare command)");
2949     return order;
2950     }
2951    
2952     /*
2953     * Parse the result of the command.
2954     */
2955    
2956     if (Tcl_GetIntFromObj(infoPtr->interp,
2957     Tcl_GetObjResult(infoPtr->interp), &order) != TCL_OK) {
2958     Tcl_ResetResult(infoPtr->interp);
2959     Tcl_AppendToObj(Tcl_GetObjResult(infoPtr->interp),
2960     "-compare command returned non-numeric result", -1);
2961     infoPtr->resultCode = TCL_ERROR;
2962     return order;
2963     }
2964     }
2965     if (!infoPtr->isIncreasing) {
2966     order = -order;
2967     }
2968     return order;
2969     }
2970    
2971     /*
2972     *----------------------------------------------------------------------
2973     *
2974     * DictionaryCompare
2975     *
2976     * This function compares two strings as if they were being used in
2977     * an index or card catalog. The case of alphabetic characters is
2978     * ignored, except to break ties. Thus "B" comes before "b" but
2979     * after "a". Also, integers embedded in the strings compare in
2980     * numerical order. In other words, "x10y" comes after "x9y", not
2981     * before it as it would when using strcmp().
2982     *
2983     * Results:
2984     * A negative result means that the first element comes before the
2985     * second, and a positive result means that the second element
2986     * should come first. A result of zero means the two elements
2987     * are equal and it doesn't matter which comes first.
2988     *
2989     * Side effects:
2990     * None.
2991     *
2992     *----------------------------------------------------------------------
2993     */
2994    
2995     static int
2996     DictionaryCompare(left, right)
2997     char *left, *right; /* The strings to compare */
2998     {
2999     Tcl_UniChar uniLeft, uniRight, uniLeftLower, uniRightLower;
3000     int diff, zeros;
3001     int secondaryDiff = 0;
3002    
3003     while (1) {
3004     if (isdigit(UCHAR(*right)) /* INTL: digit */
3005     && isdigit(UCHAR(*left))) { /* INTL: digit */
3006     /*
3007     * There are decimal numbers embedded in the two
3008     * strings. Compare them as numbers, rather than
3009     * strings. If one number has more leading zeros than
3010     * the other, the number with more leading zeros sorts
3011     * later, but only as a secondary choice.
3012     */
3013    
3014     zeros = 0;
3015     while ((*right == '0') && (isdigit(UCHAR(right[1])))) {
3016     right++;
3017     zeros--;
3018     }
3019     while ((*left == '0') && (isdigit(UCHAR(left[1])))) {
3020     left++;
3021     zeros++;
3022     }
3023     if (secondaryDiff == 0) {
3024     secondaryDiff = zeros;
3025     }
3026    
3027     /*
3028     * The code below compares the numbers in the two
3029     * strings without ever converting them to integers. It
3030     * does this by first comparing the lengths of the
3031     * numbers and then comparing the digit values.
3032     */
3033    
3034     diff = 0;
3035     while (1) {
3036     if (diff == 0) {
3037     diff = UCHAR(*left) - UCHAR(*right);
3038     }
3039     right++;
3040     left++;
3041     if (!isdigit(UCHAR(*right))) { /* INTL: digit */
3042     if (isdigit(UCHAR(*left))) { /* INTL: digit */
3043     return 1;
3044     } else {
3045     /*
3046     * The two numbers have the same length. See
3047     * if their values are different.
3048     */
3049    
3050     if (diff != 0) {
3051     return diff;
3052     }
3053     break;
3054     }
3055     } else if (!isdigit(UCHAR(*left))) { /* INTL: digit */
3056     return -1;
3057     }
3058     }
3059     continue;
3060     }
3061    
3062     /*
3063     * Convert character to Unicode for comparison purposes. If either
3064     * string is at the terminating null, do a byte-wise comparison and
3065     * bail out immediately.
3066     */
3067    
3068     if ((*left != '\0') && (*right != '\0')) {
3069     left += Tcl_UtfToUniChar(left, &uniLeft);
3070     right += Tcl_UtfToUniChar(right, &uniRight);
3071     /*
3072     * Convert both chars to lower for the comparison, because
3073     * dictionary sorts are case insensitve. Covert to lower, not
3074     * upper, so chars between Z and a will sort before A (where most
3075     * other interesting punctuations occur)
3076     */
3077     uniLeftLower = Tcl_UniCharToLower(uniLeft);
3078     uniRightLower = Tcl_UniCharToLower(uniRight);
3079     } else {
3080     diff = UCHAR(*left) - UCHAR(*right);
3081     break;
3082     }
3083    
3084     diff = uniLeftLower - uniRightLower;
3085     if (diff) {
3086     return diff;
3087     } else if (secondaryDiff == 0) {
3088     if (Tcl_UniCharIsUpper(uniLeft) &&
3089     Tcl_UniCharIsLower(uniRight)) {
3090     secondaryDiff = -1;
3091     } else if (Tcl_UniCharIsUpper(uniRight)
3092     && Tcl_UniCharIsLower(uniLeft)) {
3093     secondaryDiff = 1;
3094     }
3095     }
3096     }
3097     if (diff == 0) {
3098     diff = secondaryDiff;
3099     }
3100     return diff;
3101     }
3102    
3103    
3104     /* $History: tclcmdil.c $
3105     *
3106     * ***************** Version 1 *****************
3107     * User: Dtashley Date: 1/02/01 Time: 1:28a
3108     * Created in $/IjuScripter, IjuConsole/Source/Tcl Base
3109     * Initial check-in.
3110     */
3111    
3112     /* End of TCLCMDIL.C */

dashley@gmail.com
ViewVC Help
Powered by ViewVC 1.1.25