Tcl Source Code

Hex Artifact Content
Login

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                                         ;..