Artifact
c1870c35c78037d977d944b5cd8cac6c0a158e826b071f481e305649af8ece8f:
Attachment "parseargs.diff" to
ticket [7cb7409e05]
added by
emiliano
2024-04-03 20:30:49.
(unpublished)
0000: 49 6e 64 65 78 3a 20 64 6f 63 2f 50 61 72 73 65 Index: doc/Parse
0010: 41 72 67 73 2e 33 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d Args.3.=========
0020: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0030: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0040: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0050: 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 2d 2d 2d 20 64 6f =========.--- do
0060: 63 2f 50 61 72 73 65 41 72 67 73 2e 33 0a 2b 2b c/ParseArgs.3.++
0070: 2b 20 64 6f 63 2f 50 61 72 73 65 41 72 67 73 2e + doc/ParseArgs.
0080: 33 0a 40 40 20 2d 31 35 34 2c 31 35 20 2b 31 35 3.@@ -154,15 +15
0090: 34 2c 31 35 20 40 40 0a 20 20 20 20 20 20 20 20 4,15 @@.
00a0: 20 69 6e 74 20 5c 66 49 6f 62 6a 63 5c 66 52 2c int \fIobjc\fR,
00b0: 0a 20 20 20 20 20 20 20 20 20 54 63 6c 5f 4f 62 . Tcl_Ob
00c0: 6a 20 2a 63 6f 6e 73 74 20 2a 5c 66 49 6f 62 6a j *const *\fIobj
00d0: 76 5c 66 52 2c 0a 20 20 20 20 20 20 20 20 20 76 v\fR,. v
00e0: 6f 69 64 20 2a 5c 66 49 64 73 74 50 74 72 5c 66 oid *\fIdstPtr\f
00f0: 52 29 3b 0a 20 2e 43 45 0a 20 2e 50 50 0a 2d 54 R);. .CE. .PP.-T
0100: 68 65 20 5c 66 49 63 6c 69 65 6e 74 44 61 74 61 he \fIclientData
0110: 5c 66 52 20 69 73 20 74 68 65 20 76 61 6c 75 65 \fR is the value
0120: 20 66 72 6f 6d 20 74 68 65 20 74 61 62 6c 65 20 from the table
0130: 65 6e 74 72 79 2c 20 74 68 65 20 5c 66 49 69 6e entry, the \fIin
0140: 74 65 72 70 5c 66 52 20 69 73 0a 2d 77 68 65 72 terp\fR is.-wher
0150: 65 20 74 6f 20 73 74 6f 72 65 20 61 6e 79 20 65 e to store any e
0160: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 2c 20 74 rror messages, t
0170: 68 65 20 5c 66 49 6b 65 79 53 74 72 5c 66 52 20 he \fIkeyStr\fR
0180: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 is the name of t
0190: 68 65 0a 2d 61 72 67 75 6d 65 6e 74 2c 20 5c 66 he.-argument, \f
01a0: 49 6f 62 6a 63 5c 66 52 20 61 6e 64 20 5c 66 49 Iobjc\fR and \fI
01b0: 6f 62 6a 76 5c 66 52 20 64 65 73 63 72 69 62 65 objv\fR describe
01c0: 20 61 6e 20 61 72 72 61 79 20 6f 66 20 61 6c 6c an array of all
01d0: 20 74 68 65 20 72 65 6d 61 69 6e 69 6e 67 0a 2d the remaining.-
01e0: 61 72 67 75 6d 65 6e 74 73 2c 20 61 6e 64 20 5c arguments, and \
01f0: 66 49 64 73 74 50 74 72 5c 66 52 20 61 72 67 75 fIdstPtr\fR argu
0200: 6d 65 6e 74 20 74 6f 20 74 68 65 20 5c 66 42 54 ment to the \fBT
0210: 63 6c 5f 41 72 67 76 47 65 6e 46 75 6e 63 50 72 cl_ArgvGenFuncPr
0220: 6f 63 5c 66 52 20 69 73 20 74 68 65 0a 2d 6c 6f oc\fR is the.-lo
0230: 63 61 74 69 6f 6e 20 74 6f 20 77 72 69 74 65 20 cation to write
0240: 74 68 65 20 70 61 72 73 65 64 20 76 61 6c 75 65 the parsed value
0250: 20 28 6f 72 20 76 61 6c 75 65 73 29 20 74 6f 2e (or values) to.
0260: 0a 2b 54 68 65 20 5c 66 49 63 6c 69 65 6e 74 44 .+The \fIclientD
0270: 61 74 61 5c 66 52 20 69 73 20 74 68 65 20 76 61 ata\fR is the va
0280: 6c 75 65 20 66 72 6f 6d 20 74 68 65 20 74 61 62 lue from the tab
0290: 6c 65 20 65 6e 74 72 79 2c 20 74 68 65 20 5c 66 le entry, the \f
02a0: 49 69 6e 74 65 72 70 5c 66 52 0a 2b 69 73 20 77 Iinterp\fR.+is w
02b0: 68 65 72 65 20 74 6f 20 73 74 6f 72 65 20 61 6e here to store an
02c0: 79 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 73 y error messages
02d0: 2c 20 5c 66 49 6f 62 6a 63 5c 66 52 20 61 6e 64 , \fIobjc\fR and
02e0: 20 5c 66 49 6f 62 6a 76 5c 66 52 20 64 65 73 63 \fIobjv\fR desc
02f0: 72 69 62 65 0a 2b 61 6e 20 61 72 72 61 79 20 6f ribe.+an array o
0300: 66 20 61 6c 6c 20 74 68 65 20 72 65 6d 61 69 6e f all the remain
0310: 69 6e 67 20 61 72 67 75 6d 65 6e 74 73 2c 20 61 ing arguments, a
0320: 6e 64 20 5c 66 49 64 73 74 50 74 72 5c 66 52 20 nd \fIdstPtr\fR
0330: 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 0a argument to the.
0340: 2b 5c 66 42 54 63 6c 5f 41 72 67 76 47 65 6e 46 +\fBTcl_ArgvGenF
0350: 75 6e 63 50 72 6f 63 5c 66 52 20 69 73 20 74 68 uncProc\fR is th
0360: 65 20 6c 6f 63 61 74 69 6f 6e 20 74 6f 20 77 72 e location to wr
0370: 69 74 65 20 74 68 65 20 70 61 72 73 65 64 20 76 ite the parsed v
0380: 61 6c 75 65 0a 2b 28 6f 72 20 76 61 6c 75 65 73 alue.+(or values
0390: 29 20 74 6f 2e 0a 20 2e 52 45 0a 20 2e 54 50 0a ) to.. .RE. .TP.
03a0: 20 5c 66 42 54 43 4c 5f 41 52 47 56 5f 48 45 4c \fBTCL_ARGV_HEL
03b0: 50 5c 66 52 0a 20 2e 0a 20 54 68 69 73 20 73 70 P\fR. .. This sp
03c0: 65 63 69 61 6c 20 61 72 67 75 6d 65 6e 74 20 64 ecial argument d
03d0: 6f 65 73 20 6e 6f 74 20 74 61 6b 65 20 61 6e 79 oes not take any
03e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 76 61 6c 75 65 following value
03f0: 20 61 72 67 75 6d 65 6e 74 2c 20 62 75 74 20 69 argument, but i
0400: 6e 73 74 65 61 64 0a 0a 49 6e 64 65 78 3a 20 67 nstead..Index: g
0410: 65 6e 65 72 69 63 2f 74 63 6c 49 6e 64 65 78 4f eneric/tclIndexO
0420: 62 6a 2e 63 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d bj.c.===========
0430: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0440: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0450: 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d ================
0460: 3d 3d 3d 3d 3d 3d 3d 0a 2d 2d 2d 20 67 65 6e 65 =======.--- gene
0470: 72 69 63 2f 74 63 6c 49 6e 64 65 78 4f 62 6a 2e ric/tclIndexObj.
0480: 63 0a 2b 2b 2b 20 67 65 6e 65 72 69 63 2f 74 63 c.+++ generic/tc
0490: 6c 49 6e 64 65 78 4f 62 6a 2e 63 0a 40 40 20 2d lIndexObj.c.@@ -
04a0: 31 31 31 31 2c 31 30 20 2b 31 31 31 31 2c 31 31 1111,10 +1111,11
04b0: 20 40 40 0a 20 20 20 20 20 54 63 6c 5f 53 69 7a @@. Tcl_Siz
04c0: 65 20 64 73 74 49 6e 64 65 78 3b 09 2f 2a 20 55 e dstIndex;./* U
04d0: 73 65 64 20 74 6f 20 6b 65 65 70 20 74 72 61 63 sed to keep trac
04e0: 6b 20 6f 66 20 63 75 72 72 65 6e 74 20 61 72 67 k of current arg
04f0: 75 6d 65 6e 74 73 0a 20 09 09 09 09 20 2a 20 62 uments. .... * b
0500: 65 69 6e 67 20 70 72 6f 63 65 73 73 65 64 2c 20 eing processed,
0510: 70 72 69 6d 61 72 69 6c 79 20 66 6f 72 20 65 72 primarily for er
0520: 72 6f 72 0a 20 09 09 09 09 20 2a 20 72 65 70 6f ror. .... * repo
0530: 72 74 69 6e 67 2e 20 2a 2f 0a 20 20 20 20 20 54 rting. */. T
0540: 63 6c 5f 53 69 7a 65 20 6f 62 6a 63 3b 09 09 2f cl_Size objc;../
0550: 2a 20 23 20 61 72 67 75 6d 65 6e 74 73 20 69 6e * # arguments in
0560: 20 6f 62 6a 76 20 73 74 69 6c 6c 20 74 6f 20 70 objv still to p
0570: 72 6f 63 65 73 73 2e 20 2a 2f 0a 20 20 20 20 20 rocess. */.
0580: 54 63 6c 5f 53 69 7a 65 20 6c 65 6e 67 74 68 3b Tcl_Size length;
0590: 09 09 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 ../* Number of c
05a0: 68 61 72 61 63 74 65 72 73 20 69 6e 20 63 75 72 haracters in cur
05b0: 72 65 6e 74 20 61 72 67 75 6d 65 6e 74 20 2a 2f rent argument */
05c0: 0a 2b 20 20 20 20 54 63 6c 5f 53 69 7a 65 20 67 .+ Tcl_Size g
05d0: 66 5f 72 65 74 3b 09 09 2f 2a 20 52 65 74 75 72 f_ret;../* Retur
05e0: 6e 20 76 61 6c 75 65 20 66 72 6f 6d 20 54 63 6c n value from Tcl
05f0: 5f 41 72 67 76 47 65 6e 46 75 6e 63 50 72 6f 63 _ArgvGenFuncProc
0600: 2a 2f 0a 20 0a 20 20 20 20 20 69 66 20 28 72 65 */. . if (re
0610: 6d 4f 62 6a 76 20 21 3d 20 4e 55 4c 4c 29 20 7b mObjv != NULL) {
0620: 0a 20 09 2f 2a 0a 20 09 20 2a 20 54 68 65 6e 20 . ./*. . * Then
0630: 77 65 20 73 68 6f 75 6c 64 20 63 6f 70 79 20 74 we should copy t
0640: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63 he name of the c
0650: 6f 6d 6d 61 6e 64 20 28 30 74 68 20 61 72 67 75 ommand (0th argu
0660: 6d 65 6e 74 29 2e 20 54 68 65 0a 20 09 20 2a 20 ment). The. . *
0670: 75 70 70 65 72 20 62 6f 75 6e 64 20 6f 6e 20 74 upper bound on t
0680: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 65 6c 65 he number of ele
0690: 6d 65 6e 74 73 20 69 73 20 6b 6e 6f 77 6e 2c 20 ments is known,
06a0: 61 6e 64 20 28 75 6e 64 6f 63 75 6d 65 6e 74 65 and (undocumente
06b0: 64 2c 0a 40 40 20 2d 31 32 36 36 2c 31 34 20 2b d,.@@ -1266,14 +
06c0: 31 32 36 37 2c 31 37 20 40 40 0a 20 09 7d 0a 20 1267,17 @@. .}.
06d0: 09 63 61 73 65 20 54 43 4c 5f 41 52 47 56 5f 47 .case TCL_ARGV_G
06e0: 45 4e 46 55 4e 43 3a 20 7b 0a 20 09 20 20 20 20 ENFUNC: {. .
06f0: 54 63 6c 5f 41 72 67 76 47 65 6e 46 75 6e 63 50 Tcl_ArgvGenFuncP
0700: 72 6f 63 20 2a 68 61 6e 64 6c 65 72 50 72 6f 63 roc *handlerProc
0710: 20 3d 20 28 54 63 6c 5f 41 72 67 76 47 65 6e 46 = (Tcl_ArgvGenF
0720: 75 6e 63 50 72 6f 63 20 2a 29 0a 20 09 09 20 20 uncProc *). ..
0730: 20 20 69 6e 66 6f 50 74 72 2d 3e 73 72 63 50 74 infoPtr->srcPt
0740: 72 3b 0a 20 0a 2d 09 20 20 20 20 6f 62 6a 63 20 r;. .-. objc
0750: 3d 20 68 61 6e 64 6c 65 72 50 72 6f 63 28 69 6e = handlerProc(in
0760: 66 6f 50 74 72 2d 3e 63 6c 69 65 6e 74 44 61 74 foPtr->clientDat
0770: 61 2c 20 69 6e 74 65 72 70 2c 20 6f 62 6a 63 2c a, interp, objc,
0780: 0a 2b 09 20 20 20 20 67 66 5f 72 65 74 20 3d 20 .+. gf_ret =
0790: 68 61 6e 64 6c 65 72 50 72 6f 63 28 69 6e 66 6f handlerProc(info
07a0: 50 74 72 2d 3e 63 6c 69 65 6e 74 44 61 74 61 2c Ptr->clientData,
07b0: 20 69 6e 74 65 72 70 2c 20 6f 62 6a 63 2c 0a 20 interp, objc,.
07c0: 09 09 20 20 20 20 26 6f 62 6a 76 5b 73 72 63 49 .. &objv[srcI
07d0: 6e 64 65 78 5d 2c 20 69 6e 66 6f 50 74 72 2d 3e ndex], infoPtr->
07e0: 64 73 74 50 74 72 29 3b 0a 2d 09 20 20 20 20 69 dstPtr);.-. i
07f0: 66 20 28 6f 62 6a 63 20 3c 20 30 29 20 7b 0a 2b f (objc < 0) {.+
0800: 09 20 20 20 20 69 66 20 28 67 66 5f 72 65 74 20 . if (gf_ret
0810: 3c 20 30 29 20 7b 0a 20 09 09 67 6f 74 6f 20 65 < 0) {. ..goto e
0820: 72 72 6f 72 3b 0a 2b 09 20 20 20 20 7d 20 65 6c rror;.+. } el
0830: 73 65 20 7b 0a 2b 09 09 73 72 63 49 6e 64 65 78 se {.+..srcIndex
0840: 20 2b 3d 20 67 66 5f 72 65 74 3b 0a 2b 09 09 6f += gf_ret;.+..o
0850: 62 6a 63 20 2d 3d 20 67 66 5f 72 65 74 3b 0a 20 bjc -= gf_ret;.
0860: 09 20 20 20 20 7d 0a 20 09 20 20 20 20 62 72 65 . }. . bre
0870: 61 6b 3b 0a 20 09 7d 0a 20 09 63 61 73 65 20 54 ak;. .}. .case T
0880: 43 4c 5f 41 52 47 56 5f 48 45 4c 50 3a 0a 20 09 CL_ARGV_HELP:. .
0890: 20 20 20 20 50 72 69 6e 74 55 73 61 67 65 28 69 PrintUsage(i
08a0: 6e 74 65 72 70 2c 20 61 72 67 54 61 62 6c 65 29 nterp, argTable)
08b0: 3b 0a 0a ;..