Hex Artifact Content

Artifact 682b700009613e07de3ae7d7f1472fc407d89b13:

Wiki page [Getting Started] by User 2016-11-17 03:26:34.
0000: 44 20 32 30 31 36 2d 31 31 2d 31 37 54 30 33 3a  D 2016-11-17T03:
0010: 32 36 3a 33 34 2e 31 33 39 0a 4c 20 47 65 74 74  26:34.139.L Gett
0020: 69 6e 67 5c 73 53 74 61 72 74 65 64 0a 50 20 61  ing\sStarted.P a
0030: 63 61 34 32 62 31 35 32 34 61 35 36 39 30 62 65  ca42b1524a5690be
0040: 34 33 37 31 33 33 63 63 64 37 32 31 35 37 36 66  437133ccd721576f
0050: 63 34 37 63 39 36 64 0a 55 20 55 73 65 72 0a 57  c47c96d.U User.W
0060: 20 39 33 33 39 0a 3c 68 31 3e 3c 69 3e 47 65 74   9339.<h1><i>Get
0070: 74 69 6e 67 20 53 74 61 72 74 65 64 3c 2f 69 3e  ting Started</i>
0080: 3c 2f 68 31 3e 0a 0a 3c 70 3e 3c 66 6f 6e 74 20  </h1>..<p><font 
0090: 73 69 7a 65 3d 22 33 22 3e 53 6f 2c 20 79 6f 75  size="3">So, you
00a0: 20 61 72 65 20 69 6e 74 65 72 65 73 74 65 64 20   are interested 
00b0: 69 6e 20 75 73 69 6e 67 20 50 43 6f 6d 62 3f 20  in using PComb? 
00c0: 44 6f 69 6e 67 20 73 6f 20 69 73 20 76 65 72 79  Doing so is very
00d0: 20 65 61 73 79 2e 0a 53 74 61 72 74 20 62 79 20   easy..Start by 
00e0: 74 61 6b 69 6e 67 20 61 20 67 6f 6f 64 20 6c 6f  taking a good lo
00f0: 6f 6b 20 61 74 20 74 68 65 20 64 65 6d 6f 20 61  ok at the demo a
0100: 70 70 20 69 6e 20 74 68 65 20 3c 69 3e 61 70 70  pp in the <i>app
0110: 2f 3c 2f 69 3e 26 6e 62 73 70 3b 73 75 62 66 6f  /</i>&nbsp;subfo
0120: 6c 64 65 72 2c 0a 61 6e 64 20 77 68 65 6e 20 79  lder,.and when y
0130: 6f 75 20 61 72 65 20 72 65 61 64 79 2c 20 68 65  ou are ready, he
0140: 72 65 20 61 72 65 20 74 68 65 20 73 74 65 70 73  re are the steps
0150: 3a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c 70  :</font></p>..<p
0160: 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e  ><font size="3">
0170: 31 2e 20 49 6e 63 6c 75 64 65 20 74 68 65 20 66  1. Include the f
0180: 69 6c 65 20 3c 69 3e 70 63 6f 6d 62 2e 74 73 3c  ile <i>pcomb.ts<
0190: 2f 69 3e 20 69 6e 20 26 6e 62 73 70 3b 79 6f 75  /i> in &nbsp;you
01a0: 72 20 70 72 6f 6a 65 63 74 2e 20 49 66 0a 69 74  r project. If.it
01b0: 20 69 73 20 61 20 54 79 70 65 53 63 72 69 70 74   is a TypeScript
01c0: 20 70 72 6f 6a 65 63 74 2c 20 61 64 6a 75 73 74   project, adjust
01d0: 20 79 6f 75 72 20 62 75 69 6c 64 20 73 63 72 69   your build scri
01e0: 70 74 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20  pt to make sure 
01f0: 74 68 61 74 20 69 74 20 67 65 74 73 0a 63 6f 6d  that it gets.com
0200: 70 69 6c 65 64 20 61 6c 6f 6e 67 20 77 69 74 68  piled along with
0210: 20 61 6e 79 20 6f 74 68 65 72 20 64 65 70 65 6e   any other depen
0220: 64 65 6e 63 69 65 73 2e 3c 2f 66 6f 6e 74 3e 3c  dencies.</font><
0230: 2f 70 3e 0a 0a 3c 70 3e 3c 66 6f 6e 74 20 73 69  /p>..<p><font si
0240: 7a 65 3d 22 33 22 3e 0a 0a 3c 73 70 61 6e 20 73  ze="3">..<span s
0250: 74 79 6c 65 3d 22 63 6f 6c 6f 72 3a 20 72 67 62  tyle="color: rgb
0260: 28 31 37 2c 20 31 37 2c 20 31 37 29 3b 22 3e 3c  (17, 17, 17);"><
0270: 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c  font face="Arial
0280: 22 3e 32 2e 20 49 6e 20 61 6e 79 20 73 6f 75 72  ">2. In any sour
0290: 63 65 20 66 69 6c 65 0a 74 68 61 74 20 69 73 20  ce file.that is 
02a0: 67 6f 69 6e 67 20 74 6f 20 75 73 65 20 50 43 6f  going to use PCo
02b0: 6d 62 20 66 6f 72 20 70 61 72 73 69 6e 67 2c 20  mb for parsing, 
02c0: 61 64 64 20 61 20 72 65 66 65 72 65 6e 63 65 20  add a reference 
02d0: 6f 72 20 61 6e 20 69 6d 70 6f 72 74 20 73 74 61  or an import sta
02e0: 74 65 6d 65 6e 74 0a 74 6f 20 69 6e 63 6c 75 64  tement.to includ
02f0: 65 20 69 74 2c 20 6c 69 6b 65 20 74 68 69 73 3a  e it, like this:
0300: 26 6e 62 73 70 3b 3c 2f 66 6f 6e 74 3e 3c 2f 73  &nbsp;</font></s
0310: 70 61 6e 3e 0a 0a 3c 73 70 61 6e 20 73 74 79 6c  pan>..<span styl
0320: 65 3d 22 63 6f 6c 6f 72 3a 20 72 67 62 28 31 37  e="color: rgb(17
0330: 2c 20 31 37 2c 20 31 37 29 3b 20 66 6f 6e 74 2d  , 17, 17); font-
0340: 66 61 6d 69 6c 79 3a 20 41 72 69 61 6c 3b 22 3e  family: Arial;">
0350: 3c 62 3e 69 6d 70 6f 72 74 20 2a 20 61 73 20 70  <b>import * as p
0360: 63 6f 6d 62 0a 66 72 6f 6d 20 22 2e 2e 2f 73 72  comb.from "../sr
0370: 63 2f 70 63 6f 6d 62 22 20 3c 2f 62 3e 4f 66 20  c/pcomb" </b>Of 
0380: 63 6f 75 72 73 65 2c 20 74 68 65 20 70 61 74 68  course, the path
0390: 20 77 69 6c 6c 20 62 65 20 64 69 66 66 65 72 65   will be differe
03a0: 6e 74 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20  nt depending on 
03b0: 68 6f 77 0a 79 6f 75 20 68 61 76 65 20 79 6f 75  how.you have you
03c0: 72 20 70 72 6f 6a 65 63 74 20 66 69 6c 65 73 20  r project files 
03d0: 6c 61 69 64 20 6f 75 74 2e 3c 2f 73 70 61 6e 3e  laid out.</span>
03e0: 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c 70 3e  </font></p>..<p>
03f0: 0a 0a 3c 73 70 61 6e 20 73 74 79 6c 65 3d 22 63  ..<span style="c
0400: 6f 6c 6f 72 3a 20 72 67 62 28 31 37 2c 20 31 37  olor: rgb(17, 17
0410: 2c 20 31 37 29 3b 20 66 6f 6e 74 2d 66 61 6d 69  , 17); font-fami
0420: 6c 79 3a 20 41 72 69 61 6c 3b 22 3e 3c 66 6f 6e  ly: Arial;"><fon
0430: 74 20 73 69 7a 65 3d 22 33 22 3e 33 2e 20 59 6f  t size="3">3. Yo
0440: 75 0a 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 70  u.will need to p
0450: 72 6f 76 69 64 65 20 74 77 6f 20 63 6c 61 73 73  rovide two class
0460: 65 73 3a 20 6f 6e 65 20 74 68 61 74 20 69 6d 70  es: one that imp
0470: 6c 65 6d 65 6e 74 73 20 74 68 65 20 3c 69 3e 70  lements the <i>p
0480: 63 6f 6d 62 2e 50 61 72 73 65 72 49 6e 70 75 74  comb.ParserInput
0490: 3c 2f 69 3e 0a 69 6e 74 65 72 66 61 63 65 20 61  </i>.interface a
04a0: 6e 64 20 6f 6e 65 20 74 68 61 74 20 69 6d 70 6c  nd one that impl
04b0: 65 6d 65 6e 74 73 20 74 68 65 20 3c 69 3e 70 63  ements the <i>pc
04c0: 6f 6d 62 2e 50 61 72 73 65 72 4f 75 74 70 75 74  omb.ParserOutput
04d0: 3c 2f 69 3e 20 69 6e 74 65 72 66 61 63 65 20 54  </i> interface T
04e0: 68 65 0a 63 6c 61 73 73 20 74 68 61 74 20 69 6d  he.class that im
04f0: 70 6c 65 6d 65 6e 74 73 20 3c 69 3e 70 63 6f 6d  plements <i>pcom
0500: 62 2e 50 61 72 73 65 72 49 6e 70 75 74 3c 2f 69  b.ParserInput</i
0510: 3e 20 64 6f 65 73 6e 27 74 20 6e 65 65 64 20 74  > doesn't need t
0520: 6f 20 64 6f 20 6d 75 63 68 3a 20 6a 75 73 74 0a  o do much: just.
0530: 70 72 6f 76 69 64 65 20 74 68 65 20 6f 6e 65 20  provide the one 
0540: 70 72 6f 70 65 72 74 79 20 61 6e 64 20 6f 6e 65  property and one
0550: 20 6d 65 74 68 6f 64 20 72 65 71 75 69 72 65 64   method required
0560: 20 62 79 20 74 68 65 20 69 6e 74 65 72 66 61 63   by the interfac
0570: 65 2e 20 3c 69 3e 70 63 6f 6d 62 2e 50 61 72 73  e. <i>pcomb.Pars
0580: 65 72 4f 75 74 70 75 74 3c 2f 69 3e 0a 6f 6e 20  erOutput</i>.on 
0590: 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20  the other hand, 
05a0: 73 68 6f 75 6c 64 20 69 6d 70 6c 65 6d 65 6e 74  should implement
05b0: 20 74 68 65 20 72 65 71 75 69 72 65 64 20 66 69   the required fi
05c0: 65 6c 64 73 2c 20 62 75 74 20 69 74 20 61 6c 73  elds, but it als
05d0: 6f 20 6e 65 65 64 73 20 74 6f 0a 73 74 6f 72 65  o needs to.store
05e0: 20 77 68 61 74 65 76 65 72 20 6b 69 6e 64 20 6f   whatever kind o
05f0: 66 20 73 74 61 74 65 20 69 73 20 6e 65 65 64 65  f state is neede
0600: 64 20 62 79 20 79 6f 75 72 20 61 70 70 6c 69 63  d by your applic
0610: 61 74 69 6f 6e 20 74 6f 20 64 6f 20 69 74 73 20  ation to do its 
0620: 77 6f 72 6b 2e 3c 2f 66 6f 6e 74 3e 3c 2f 73 70  work.</font></sp
0630: 61 6e 3e 3c 2f 70 3e 0a 0a 3c 70 3e 0a 0a 3c 73  an></p>..<p>..<s
0640: 70 61 6e 20 73 74 79 6c 65 3d 22 63 6f 6c 6f 72  pan style="color
0650: 3a 20 72 67 62 28 31 37 2c 20 31 37 2c 20 31 37  : rgb(17, 17, 17
0660: 29 3b 20 66 6f 6e 74 2d 66 61 6d 69 6c 79 3a 20  ); font-family: 
0670: 41 72 69 61 6c 3b 22 3e 3c 66 6f 6e 74 20 73 69  Arial;"><font si
0680: 7a 65 3d 22 33 22 3e 48 65 72 65 0a 69 73 20 74  ze="3">Here.is t
0690: 68 65 20 3c 69 3e 50 61 72 73 65 72 49 6e 70 75  he <i>ParserInpu
06a0: 74 3c 2f 69 3e 20 66 72 6f 6d 20 74 68 65 20 64  t</i> from the d
06b0: 65 6d 6f 20 61 70 70 3a 3c 2f 66 6f 6e 74 3e 3c  emo app:</font><
06c0: 2f 73 70 61 6e 3e 3c 2f 70 3e 0a 3c 70 72 65 3e  /span></p>.<pre>
06d0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 20 66  <font size="3" f
06e0: 61 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77  ace="Courier New
06f0: 22 3e 63 6c 61 73 73 20 43 68 61 74 74 79 49 6e  ">class ChattyIn
0700: 70 75 74 20 69 6d 70 6c 65 6d 65 6e 74 73 20 70  put implements p
0710: 63 6f 6d 62 2e 50 61 72 73 65 72 49 6e 70 75 74  comb.ParserInput
0720: 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 70 72 65 3e   {..</font><pre>
0730: 3c 66 6f 6e 74 20 66 61 63 65 3d 22 43 6f 75 72  <font face="Cour
0740: 69 65 72 20 4e 65 77 22 3e 3c 66 6f 6e 74 20 73  ier New"><font s
0750: 69 7a 65 3d 22 33 22 3e 20 20 20 20 74 65 78 74  ize="3">    text
0760: 3a 20 73 74 72 69 6e 67 3b 0d 0a 3c 2f 66 6f 6e  : string;..</fon
0770: 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22  t><font size="3"
0780: 3e 20 20 20 20 63 6f 70 79 28 29 3a 20 70 63 6f  >    copy(): pco
0790: 6d 62 2e 50 61 72 73 65 72 49 6e 70 75 74 20 7b  mb.ParserInput {
07a0: 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73  ..</font><font s
07b0: 69 7a 65 3d 22 33 22 3e 20 20 20 20 20 20 20 20  ize="3">        
07c0: 6c 65 74 20 6e 65 77 49 6e 70 75 74 20 3d 20 6e  let newInput = n
07d0: 65 77 20 43 68 61 74 74 79 49 6e 70 75 74 28 29  ew ChattyInput()
07e0: 3b 3c 2f 66 6f 6e 74 3e 3c 2f 66 6f 6e 74 3e 3c  ;</font></font><
07f0: 2f 70 72 65 3e 3c 70 72 65 3e 3c 66 6f 6e 74 20  /pre><pre><font 
0800: 66 61 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65  face="Courier Ne
0810: 77 22 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33  w"><font size="3
0820: 22 3e 20 20 20 20 20 20 20 20 6e 65 77 49 6e 70  ">        newInp
0830: 75 74 2e 74 65 78 74 20 3d 20 74 68 69 73 2e 74  ut.text = this.t
0840: 65 78 74 3b 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74  ext;</font><font
0850: 20 73 69 7a 65 3d 22 33 22 3e 0d 0a 3c 2f 66 6f   size="3">..</fo
0860: 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33  nt><font size="3
0870: 22 3e 20 20 20 20 20 20 20 20 72 65 74 75 72 6e  ">        return
0880: 20 6e 65 77 49 6e 70 75 74 3b 0d 0a 3c 2f 66 6f   newInput;..</fo
0890: 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33  nt><font size="3
08a0: 22 3e 20 20 20 20 7d 0d 0a 3c 2f 66 6f 6e 74 3e  ">    }..</font>
08b0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 7d  <font size="3">}
08c0: 3c 2f 66 6f 6e 74 3e 3c 2f 66 6f 6e 74 3e 3c 2f  </font></font></
08d0: 70 72 65 3e 3c 2f 70 72 65 3e 0a 3c 70 72 65 3e  pre></pre>.<pre>
08e0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 3c  <font size="3"><
08f0: 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c  font face="Arial
0900: 22 3e 41 6e 64 20 68 65 72 65 20 69 73 20 74 68  ">And here is th
0910: 65 20 3c 69 3e 50 61 72 73 65 72 4f 75 74 70 75  e <i>ParserOutpu
0920: 74 3a 3c 2f 69 3e 3c 2f 66 6f 6e 74 3e 3c 2f 66  t:</i></font></f
0930: 6f 6e 74 3e 3c 2f 70 72 65 3e 0a 3c 70 72 65 3e  ont></pre>.<pre>
0940: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 20 66  <font size="3" f
0950: 61 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77  ace="Courier New
0960: 22 3e 63 6c 61 73 73 20 43 68 61 74 74 79 44 61  ">class ChattyDa
0970: 74 61 20 69 6d 70 6c 65 6d 65 6e 74 73 20 70 63  ta implements pc
0980: 6f 6d 62 2e 50 61 72 73 65 72 4f 75 74 70 75 74  omb.ParserOutput
0990: 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 70 72 65 3e   {..</font><pre>
09a0: 3c 66 6f 6e 74 20 66 61 63 65 3d 22 43 6f 75 72  <font face="Cour
09b0: 69 65 72 20 4e 65 77 22 3e 3c 66 6f 6e 74 20 73  ier New"><font s
09c0: 69 7a 65 3d 22 33 22 3e 20 20 20 20 6d 61 74 63  ize="3">    matc
09d0: 68 65 64 3a 20 73 74 72 69 6e 67 5b 5d 3b 0d 0a  hed: string[];..
09e0: 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a  </font><font siz
09f0: 65 3d 22 33 22 3e 20 20 20 20 6c 65 66 74 4f 70  e="3">    leftOp
0a00: 65 72 61 6e 64 3a 20 6e 75 6d 62 65 72 3b 0d 0a  erand: number;..
0a10: 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a  </font><font siz
0a20: 65 3d 22 33 22 3e 20 20 20 20 72 69 67 68 74 4f  e="3">    rightO
0a30: 70 65 72 61 6e 64 3a 20 6e 75 6d 62 65 72 3b 0d  perand: number;.
0a40: 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69  .</font><font si
0a50: 7a 65 3d 22 33 22 3e 20 20 20 20 6f 70 65 72 61  ze="3">    opera
0a60: 74 6f 72 3a 20 4d 61 74 68 4f 70 73 3b 0d 0a 3c  tor: MathOps;..<
0a70: 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65  /font><font size
0a80: 3d 22 33 22 3e 20 20 20 20 61 63 63 75 6d 75 6c  ="3">    accumul
0a90: 61 74 6f 72 3a 20 6e 75 6d 62 65 72 20 3d 20 30  ator: number = 0
0aa0: 3b 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69  ;</font><font si
0ab0: 7a 65 3d 22 33 22 3e 0d 0a 3c 2f 66 6f 6e 74 3e  ze="3">..</font>
0ac0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 20  <font size="3"> 
0ad0: 20 20 20 63 6f 70 79 28 29 3a 20 43 68 61 74 74     copy(): Chatt
0ae0: 79 44 61 74 61 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e  yData {..</font>
0af0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 20  <font size="3"> 
0b00: 20 20 20 20 20 20 20 6c 65 74 20 6e 65 77 44 61         let newDa
0b10: 74 61 20 3d 20 6e 65 77 20 43 68 61 74 74 79 44  ta = new ChattyD
0b20: 61 74 61 28 29 3b 3c 62 72 3e 0a 0d 0a 0d 0a 3c  ata();<br>.....<
0b30: 2f 66 6f 6e 74 3e 3c 70 3e 3c 66 6f 6e 74 20 73  /font><p><font s
0b40: 69 7a 65 3d 22 33 22 3e 20 20 20 20 20 20 20 20  ize="3">        
0b50: 69 66 20 28 6e 65 77 44 61 74 61 2e 6d 61 74 63  if (newData.matc
0b60: 68 65 64 29 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e 3c  hed) {..</font><
0b70: 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 20 20  font size="3">  
0b80: 20 20 20 20 20 20 20 20 20 20 6e 65 77 44 61 74            newDat
0b90: 61 2e 6d 61 74 63 68 65 64 20 3d 20 74 68 69 73  a.matched = this
0ba0: 2e 6d 61 74 63 68 65 64 2e 73 6c 69 63 65 28 29  .matched.slice()
0bb0: 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20  ;..</font><font 
0bc0: 73 69 7a 65 3d 22 33 22 3e 20 20 20 20 20 20 20  size="3">       
0bd0: 20 7d 20 65 6c 73 65 20 7b 0d 0a 3c 2f 66 6f 6e   } else {..</fon
0be0: 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22  t><font size="3"
0bf0: 3e 20 20 20 20 20 20 20 20 20 20 20 20 6e 65 77  >            new
0c00: 44 61 74 61 2e 6d 61 74 63 68 65 64 20 3d 20 41  Data.matched = A
0c10: 72 72 61 79 26 6c 74 3b 73 74 72 69 6e 67 26 67  rray&lt;string&g
0c20: 74 3b 28 29 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66  t;();..</font><f
0c30: 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 20 20 20  ont size="3">   
0c40: 20 20 20 20 20 7d 0d 0a 3c 2f 66 6f 6e 74 3e 3c       }..</font><
0c50: 2f 70 3e 3c 2f 66 6f 6e 74 3e 3c 70 3e 3c 66 6f  /p></font><p><fo
0c60: 6e 74 20 66 61 63 65 3d 22 43 6f 75 72 69 65 72  nt face="Courier
0c70: 20 4e 65 77 22 3e 3c 66 6f 6e 74 20 73 69 7a 65   New"><font size
0c80: 3d 22 33 22 3e 20 20 20 20 20 20 20 20 6e 65 77  ="3">        new
0c90: 44 61 74 61 2e 6c 65 66 74 4f 70 65 72 61 6e 64  Data.leftOperand
0ca0: 20 3d 20 74 68 69 73 2e 6c 65 66 74 4f 70 65 72   = this.leftOper
0cb0: 61 6e 64 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f  and;..</font><fo
0cc0: 6e 74 20 73 69 7a 65 3d 22 33 22 3e 20 20 20 20  nt size="3">    
0cd0: 20 20 20 20 6e 65 77 44 61 74 61 2e 72 69 67 68      newData.righ
0ce0: 74 4f 70 65 72 61 6e 64 20 3d 20 74 68 69 73 2e  tOperand = this.
0cf0: 72 69 67 68 74 4f 70 65 72 61 6e 64 3b 0d 0a 3c  rightOperand;..<
0d00: 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65  /font><font size
0d10: 3d 22 33 22 3e 20 20 20 20 20 20 20 20 6e 65 77  ="3">        new
0d20: 44 61 74 61 2e 6f 70 65 72 61 74 6f 72 20 3d 20  Data.operator = 
0d30: 74 68 69 73 2e 6f 70 65 72 61 74 6f 72 3b 0d 0a  this.operator;..
0d40: 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a  </font><font siz
0d50: 65 3d 22 33 22 3e 20 20 20 20 20 20 20 20 6e 65  e="3">        ne
0d60: 77 44 61 74 61 2e 61 63 63 75 6d 75 6c 61 74 6f  wData.accumulato
0d70: 72 20 3d 20 74 68 69 73 2e 61 63 63 75 6d 75 6c  r = this.accumul
0d80: 61 74 6f 72 3b 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e  ator;</font><fon
0d90: 74 20 73 69 7a 65 3d 22 33 22 3e 0d 0a 3c 2f 66  t size="3">..</f
0da0: 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22  ont><font size="
0db0: 33 22 3e 20 20 20 20 20 20 20 20 72 65 74 75 72  3">        retur
0dc0: 6e 20 6e 65 77 44 61 74 61 3b 0d 0a 3c 2f 66 6f  n newData;..</fo
0dd0: 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33  nt><font size="3
0de0: 22 3e 20 20 20 20 7d 0d 0a 3c 2f 66 6f 6e 74 3e  ">    }..</font>
0df0: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 7d  <font size="3">}
0e00: 3c 2f 66 6f 6e 74 3e 3c 2f 66 6f 6e 74 3e 3c 2f  </font></font></
0e10: 70 3e 3c 2f 70 72 65 3e 3c 2f 70 72 65 3e 0a 0a  p></pre></pre>..
0e20: 3c 70 3e 3c 66 6f 6e 74 20 66 61 63 65 3d 22 41  <p><font face="A
0e30: 72 69 61 6c 22 20 73 69 7a 65 3d 22 33 22 3e 41  rial" size="3">A
0e40: 73 20 79 6f 75 20 63 61 6e 20 73 65 65 2c 20 74  s you can see, t
0e50: 68 65 20 3c 69 3e 50 61 72 73 65 72 4f 75 74 70  he <i>ParserOutp
0e60: 75 74 3c 2f 69 3e 0a 69 6d 70 6c 65 6d 65 6e 74  ut</i>.implement
0e70: 69 6e 67 20 63 6c 61 73 73 20 61 64 64 73 20 61  ing class adds a
0e80: 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 65 6c 64   number of field
0e90: 73 20 2d 2d 20 3c 69 3e 6c 65 66 74 4f 70 65 72  s -- <i>leftOper
0ea0: 61 6e 64 2c 20 72 69 67 68 74 4f 70 65 72 61 6e  and, rightOperan
0eb0: 64 2c 0a 6f 70 65 72 61 74 6f 72 3c 2f 69 3e 20  d,.operator</i> 
0ec0: 61 6e 64 20 3c 69 3e 61 63 63 75 6d 75 6c 61 74  and <i>accumulat
0ed0: 6f 72 3c 2f 69 3e 20 2d 2d 20 74 68 61 74 20 61  or</i> -- that a
0ee0: 72 65 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65  re used to store
0ef0: 20 74 68 65 20 64 61 74 61 20 74 68 61 74 20 69   the data that i
0f00: 73 0a 63 6f 6c 6c 65 63 74 65 64 20 62 79 20 74  s.collected by t
0f10: 68 65 20 70 61 72 73 65 72 73 20 74 68 61 74 20  he parsers that 
0f20: 74 68 65 20 61 70 70 20 64 65 66 69 6e 65 73 2e  the app defines.
0f30: 20 54 68 69 73 20 74 75 74 6f 72 69 61 6c 20 77   This tutorial w
0f40: 69 6c 6c 20 63 6f 76 65 72 20 74 68 65 0a 6d 65  ill cover the.me
0f50: 63 68 61 6e 69 73 6d 20 66 6f 72 20 67 65 74 74  chanism for gett
0f60: 69 6e 67 20 64 61 74 61 20 69 6e 74 6f 20 74 68  ing data into th
0f70: 65 20 6f 62 6a 65 63 74 20 6c 61 74 65 72 2e 3c  e object later.<
0f80: 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c 70 3e 3c  /font></p>..<p><
0f90: 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c  font face="Arial
0fa0: 22 20 73 69 7a 65 3d 22 33 22 3e 34 2e 20 4e 6f  " size="3">4. No
0fb0: 77 20 69 74 20 69 73 20 74 69 6d 65 20 74 6f 20  w it is time to 
0fc0: 61 63 74 75 61 6c 6c 79 20 63 72 65 61 74 65 20  actually create 
0fd0: 61 20 70 61 72 73 65 72 2e 0a 4d 6f 73 74 20 62  a parser..Most b
0fe0: 65 67 69 6e 20 77 69 74 68 20 6f 6e 65 20 6f 72  egin with one or
0ff0: 20 6d 6f 72 65 20 3c 69 3e 6c 69 74 3c 2f 69 3e   more <i>lit</i>
1000: 26 6e 62 73 70 3b 70 61 72 73 65 72 73 3b 20 74  &nbsp;parsers; t
1010: 68 65 79 20 6d 61 74 63 68 20 61 20 66 69 78 65  hey match a fixe
1020: 64 2c 0a 63 61 73 65 6c 65 73 73 20 73 74 72 69  d,.caseless stri
1030: 6e 67 20 6f 66 20 6f 6e 65 2d 6f 72 2d 6d 6f 72  ng of one-or-mor
1040: 65 20 63 68 61 72 61 74 63 65 72 73 2e 20 41 67  e charatcers. Ag
1050: 61 69 6e 20 74 61 6b 69 6e 67 20 61 6e 20 65 78  ain taking an ex
1060: 61 6d 70 6c 65 20 66 72 6f 6d 20 74 68 65 0a 64  ample from the.d
1070: 65 6d 6f 20 61 70 70 2c 20 6c 65 74 27 73 20 63  emo app, let's c
1080: 72 65 61 74 65 20 70 61 72 73 65 72 73 20 74 68  reate parsers th
1090: 61 74 20 72 65 70 72 65 73 65 6e 74 20 74 68 65  at represent the
10a0: 20 61 72 69 74 68 6d 65 74 69 63 20 6f 70 65 72   arithmetic oper
10b0: 61 74 6f 72 73 20 66 6f 72 0a 61 64 64 69 74 69  ators for.additi
10c0: 6f 6e 2c 20 73 75 62 74 72 61 63 74 69 6f 6e 2c  on, subtraction,
10d0: 20 6d 75 6c 74 69 70 6c 69 63 61 74 69 6f 6e 20   multiplication 
10e0: 61 6e 64 20 64 69 76 69 73 69 6f 6e 2e 3c 2f 66  and division.</f
10f0: 6f 6e 74 3e 3c 2f 70 3e 0a 3c 70 72 65 3e 3c 66  ont></p>.<pre><f
1100: 6f 6e 74 20 73 69 7a 65 3d 22 33 22 20 66 61 63  ont size="3" fac
1110: 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77 22 3e  e="Courier New">
1120: 6c 65 74 20 6f 70 65 72 61 6e 64 50 6c 75 73 3a  let operandPlus:
1130: 20 70 63 6f 6d 62 2e 50 61 72 73 65 72 20 3d 20   pcomb.Parser = 
1140: 70 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 66 61  p</font><font fa
1150: 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77 22  ce="Courier New"
1160: 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e  ><font size="3">
1170: 63 6f 6d 62 2e 6c 69 74 28 22 2b 22 29 3b 3c 2f  comb.lit("+");</
1180: 66 6f 6e 74 3e 3c 73 70 61 6e 20 73 74 79 6c 65  font><span style
1190: 3d 22 66 6f 6e 74 2d 73 69 7a 65 3a 20 6d 65 64  ="font-size: med
11a0: 69 75 6d 3b 22 3e 26 6e 62 73 70 3b 3c 2f 73 70  ium;">&nbsp;</sp
11b0: 61 6e 3e 3c 2f 66 6f 6e 74 3e 3c 2f 70 72 65 3e  an></font></pre>
11c0: 0a 0a 3c 70 3e 3c 66 6f 6e 74 20 66 61 63 65 3d  ..<p><font face=
11d0: 22 41 72 69 61 6c 22 20 73 69 7a 65 3d 22 33 22  "Arial" size="3"
11e0: 3e 48 65 72 65 20 77 65 20 61 72 65 20 64 65 63  >Here we are dec
11f0: 6c 61 72 69 6e 67 20 61 20 76 61 72 69 61 62 6c  laring a variabl
1200: 65 20 6f 66 20 74 79 70 65 20 3c 69 3e 70 63 6f  e of type <i>pco
1210: 6d 62 2e 50 61 72 73 65 72 3c 2f 69 3e 0a 61 6e  mb.Parser</i>.an
1220: 64 20 63 61 6c 6c 20 74 68 65 20 3c 69 3e 6c 69  d call the <i>li
1230: 74 3c 2f 69 3e 26 6e 62 73 70 3b 66 75 6e 63 74  t</i>&nbsp;funct
1240: 69 6f 6e 20 74 6f 20 63 72 65 61 74 65 20 61 20  ion to create a 
1250: 70 61 72 73 65 72 20 74 68 61 74 20 77 69 6c 6c  parser that will
1260: 20 6d 61 74 63 68 20 61 20 70 6c 75 73 0a 73 69   match a plus.si
1270: 67 6e 2e 20 54 68 61 74 20 69 73 20 61 6c 6c 20  gn. That is all 
1280: 77 65 6c 6c 20 61 6e 64 20 67 6f 6f 64 2c 20 62  well and good, b
1290: 75 74 20 6e 6f 74 68 69 6e 67 20 77 69 6c 6c 20  ut nothing will 
12a0: 68 61 70 70 65 6e 20 61 73 69 64 65 20 66 72 6f  happen aside fro
12b0: 6d 20 70 61 72 73 69 6e 67 0a 63 6f 6e 74 69 6e  m parsing.contin
12c0: 75 69 6e 67 2e 20 57 68 61 74 20 77 65 20 77 61  uing. What we wa
12d0: 6e 74 20 69 73 20 66 6f 72 20 74 68 65 20 3c 69  nt is for the <i
12e0: 3e 6f 70 65 72 61 74 6f 72 3c 2f 69 3e 26 6e 62  >operator</i>&nb
12f0: 73 70 3b 66 69 65 6c 64 20 69 6e 20 6f 75 72 0a  sp;field in our.
1300: 43 68 61 74 74 79 44 61 74 61 20 6f 62 6a 65 63  ChattyData objec
1310: 74 20 74 6f 20 62 65 20 73 65 74 20 63 6f 72 72  t to be set corr
1320: 65 63 74 6c 79 2e 20 54 6f 20 64 6f 20 74 68 61  ectly. To do tha
1330: 74 2c 20 77 65 20 77 69 6c 6c 20 6e 65 65 64 20  t, we will need 
1340: 74 6f 20 64 65 66 69 6e 65 20 61 20 3c 69 3e 50  to define a <i>P
1350: 61 72 73 65 72 41 63 74 69 6f 6e 2e 3c 2f 69 3e  arserAction.</i>
1360: 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c 70 3e  </font></p>..<p>
1370: 3c 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61  <font face="Aria
1380: 6c 22 20 73 69 7a 65 3d 22 33 22 3e 35 2e 20 41  l" size="3">5. A
1390: 64 64 20 61 20 50 61 72 73 65 72 41 63 74 69 6f  dd a ParserActio
13a0: 6e 20 66 75 6e 63 74 69 6f 6e 20 74 68 61 74 20  n function that 
13b0: 63 61 6e 20 62 65 0a 63 61 6c 6c 65 64 20 62 79  can be.called by
13c0: 20 74 68 65 20 70 61 72 73 65 72 20 74 68 61 74   the parser that
13d0: 20 6d 61 74 63 68 65 73 20 6d 61 74 68 20 6f 70   matches math op
13e0: 65 72 61 74 6f 72 73 3a 3c 2f 66 6f 6e 74 3e 3c  erators:</font><
13f0: 2f 70 3e 0a 3c 70 72 65 3e 3c 66 6f 6e 74 20 66  /p>.<pre><font f
1400: 61 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77  ace="Courier New
1410: 22 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22  "><font size="3"
1420: 3e 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 70  >&nbsp; &nbsp; p
1430: 72 69 76 61 74 65 20 6f 70 65 72 61 6e 64 53 65  rivate operandSe
1440: 74 28 6d 61 74 63 68 65 64 3a 20 73 74 72 69 6e  t(matched: strin
1450: 67 2c 20 6f 75 74 70 75 74 3a 20 70 63 6f 6d 62  g, output: pcomb
1460: 2e 50 61 72 73 65 72 4f 75 74 70 75 74 29 3a 20  .ParserOutput): 
1470: 70 63 6f 6d 62 2e 50 61 72 73 65 72 4f 75 74 70  pcomb.ParserOutp
1480: 75 74 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f  ut {..</font><fo
1490: 6e 74 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73  nt size="3">&nbs
14a0: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
14b0: 20 26 6e 62 73 70 3b 20 6c 65 74 20 72 65 73 75   &nbsp; let resu
14c0: 6c 74 3a 20 43 68 61 74 74 79 44 61 74 61 20 3d  lt: ChattyData =
14d0: 20 26 6c 74 3b 43 68 61 74 74 79 44 61 74 61 26   &lt;ChattyData&
14e0: 67 74 3b 6f 75 74 70 75 74 2e 63 6f 70 79 28 29  gt;output.copy()
14f0: 3b 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69  ;</font><font si
1500: 7a 65 3d 22 33 22 3e 3c 62 72 3e 0a 0d 0a 0d 0a  ze="3"><br>.....
1510: 3c 2f 66 6f 6e 74 3e 3c 70 3e 3c 66 6f 6e 74 20  </font><p><font 
1520: 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20  size="3">&nbsp; 
1530: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
1540: 62 73 70 3b 20 73 77 69 74 63 68 20 28 6d 61 74  bsp; switch (mat
1550: 63 68 65 64 29 20 7b 0d 0a 3c 2f 66 6f 6e 74 3e  ched) {..</font>
1560: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 26  <font size="3">&
1570: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
1580: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1590: 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20 22 2b  ; &nbsp; case "+
15a0: 22 3a 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74  ":..</font><font
15b0: 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b   size="3">&nbsp;
15c0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26   &nbsp; &nbsp; &
15d0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
15e0: 73 70 3b 20 63 61 73 65 20 22 70 6c 75 73 22 3a  sp; case "plus":
15f0: 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73  ..</font><font s
1600: 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20 26  ize="3">&nbsp; &
1610: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
1620: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1630: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20  ; &nbsp; &nbsp; 
1640: 72 65 73 75 6c 74 2e 6f 70 65 72 61 74 6f 72 20  result.operator 
1650: 3d 20 4d 61 74 68 4f 70 73 2e 41 64 64 3b 0d 0a  = MathOps.Add;..
1660: 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a  </font><font siz
1670: 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20 26 6e 62  e="3">&nbsp; &nb
1680: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1690: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20  ; &nbsp; &nbsp; 
16a0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 62 72  &nbsp; &nbsp; br
16b0: 65 61 6b 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f  eak;..</font><fo
16c0: 6e 74 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73  nt size="3">&nbs
16d0: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
16e0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26   &nbsp; &nbsp; &
16f0: 6e 62 73 70 3b 20 63 61 73 65 20 22 2d 22 3a 0d  nbsp; case "-":.
1700: 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69  .</font><font si
1710: 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20 26 6e  ze="3">&nbsp; &n
1720: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
1730: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
1740: 20 63 61 73 65 20 22 6d 69 6e 75 73 22 3a 0d 0a   case "minus":..
1750: 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a  </font><font siz
1760: 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20 26 6e 62  e="3">&nbsp; &nb
1770: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1780: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20  ; &nbsp; &nbsp; 
1790: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 72 65  &nbsp; &nbsp; re
17a0: 73 75 6c 74 2e 6f 70 65 72 61 74 6f 72 20 3d 20  sult.operator = 
17b0: 4d 61 74 68 4f 70 73 2e 53 75 62 74 72 61 63 74  MathOps.Subtract
17c0: 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20  ;..</font><font 
17d0: 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20  size="3">&nbsp; 
17e0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
17f0: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
1800: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
1810: 20 62 72 65 61 6b 3b 0d 0a 3c 2f 66 6f 6e 74 3e   break;..</font>
1820: 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e 26  <font size="3">&
1830: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
1840: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1850: 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20 22 2a  ; &nbsp; case "*
1860: 22 3a 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74  ":..</font><font
1870: 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b   size="3">&nbsp;
1880: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26   &nbsp; &nbsp; &
1890: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
18a0: 73 70 3b 20 63 61 73 65 20 22 74 69 6d 65 73 22  sp; case "times"
18b0: 3a 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20  :..</font><font 
18c0: 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20  size="3">&nbsp; 
18d0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
18e0: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
18f0: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
1900: 20 72 65 73 75 6c 74 2e 6f 70 65 72 61 74 6f 72   result.operator
1910: 20 3d 20 4d 61 74 68 4f 70 73 2e 4d 75 6c 74 69   = MathOps.Multi
1920: 70 79 3b 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e  py;..</font><fon
1930: 74 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73 70  t size="3">&nbsp
1940: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20  ; &nbsp; &nbsp; 
1950: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
1960: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
1970: 70 3b 20 62 72 65 61 6b 3b 0d 0a 3c 2f 66 6f 6e  p; break;..</fon
1980: 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22  t><font size="3"
1990: 3e 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26  >&nbsp; &nbsp; &
19a0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
19b0: 73 70 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20  sp; &nbsp; case 
19c0: 22 2f 22 3a 0d 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f  "/":..</font><fo
19d0: 6e 74 20 73 69 7a 65 3d 22 33 22 3e 26 6e 62 73  nt size="3">&nbs
19e0: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
19f0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26   &nbsp; &nbsp; &
1a00: 6e 62 73 70 3b 20 63 61 73 65 20 22 64 69 76 69  nbsp; case "divi
1a10: 64 65 64 20 62 79 22 3a 0d 0a 3c 2f 66 6f 6e 74  ded by":..</font
1a20: 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e  ><font size="3">
1a30: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
1a40: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
1a50: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b  p; &nbsp; &nbsp;
1a60: 20 26 6e 62 73 70 3b 20 72 65 73 75 6c 74 2e 6f   &nbsp; result.o
1a70: 70 65 72 61 74 6f 72 20 3d 20 4d 61 74 68 4f 70  perator = MathOp
1a80: 73 2e 44 69 76 69 64 65 3b 0d 0a 3c 2f 66 6f 6e  s.Divide;..</fon
1a90: 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22  t><font size="3"
1aa0: 3e 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26  >&nbsp; &nbsp; &
1ab0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62  nbsp; &nbsp; &nb
1ac0: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70  sp; &nbsp; &nbsp
1ad0: 3b 20 26 6e 62 73 70 3b 20 62 72 65 61 6b 3b 0d  ; &nbsp; break;.
1ae0: 0a 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74 20 73 69  .</font><font si
1af0: 7a 65 3d 22 33 22 3e 26 6e 62 73 70 3b 20 26 6e  ze="3">&nbsp; &n
1b00: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73  bsp; &nbsp; &nbs
1b10: 70 3b 20 7d 3c 2f 66 6f 6e 74 3e 3c 66 6f 6e 74  p; }</font><font
1b20: 20 73 69 7a 65 3d 22 33 22 3e 3c 62 72 3e 0a 0d   size="3"><br>..
1b30: 0a 0d 0a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 3c 2f  ...</font></p></
1b40: 66 6f 6e 74 3e 3c 70 3e 3c 66 6f 6e 74 20 66 61  font><p><font fa
1b50: 63 65 3d 22 43 6f 75 72 69 65 72 20 4e 65 77 22  ce="Courier New"
1b60: 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33 22 3e  ><font size="3">
1b70: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e  &nbsp; &nbsp; &n
1b80: 62 73 70 3b 20 26 6e 62 73 70 3b 20 72 65 74 75  bsp; &nbsp; retu
1b90: 72 6e 20 72 65 73 75 6c 74 3b 0d 0a 3c 2f 66 6f  rn result;..</fo
1ba0: 6e 74 3e 3c 66 6f 6e 74 20 73 69 7a 65 3d 22 33  nt><font size="3
1bb0: 22 3e 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20  ">&nbsp; &nbsp; 
1bc0: 7d 3c 2f 66 6f 6e 74 3e 3c 2f 66 6f 6e 74 3e 3c  }</font></font><
1bd0: 2f 70 3e 3c 2f 70 72 65 3e 0a 0a 3c 70 3e 3c 66  /p></pre>..<p><f
1be0: 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c 22  ont face="Arial"
1bf0: 20 73 69 7a 65 3d 22 33 22 3e 4e 6f 74 65 20 74   size="3">Note t
1c00: 68 61 74 20 74 68 69 73 20 66 75 6e 63 74 69 6f  hat this functio
1c10: 6e 20 6d 61 74 63 68 65 73 20 74 68 65 20 73 69  n matches the si
1c20: 67 6e 61 74 75 72 65 20 6f 66 0a 74 68 65 20 3c  gnature of.the <
1c30: 69 3e 50 61 72 73 65 72 41 63 74 69 6f 6e 3c 2f  i>ParserAction</
1c40: 69 3e 26 6e 62 73 70 3b 74 79 70 65 20 61 73 20  i>&nbsp;type as 
1c50: 64 65 66 69 6e 65 64 20 69 6e 20 70 63 6f 6d 62  defined in pcomb
1c60: 2e 74 73 3a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a  .ts:</font></p>.
1c70: 3c 70 72 65 3e 3c 66 6f 6e 74 20 66 61 63 65 3d  <pre><font face=
1c80: 22 43 6f 75 72 69 65 72 20 4e 65 77 22 20 73 69  "Courier New" si
1c90: 7a 65 3d 22 32 22 3e 65 78 70 6f 72 74 20 74 79  ze="2">export ty
1ca0: 70 65 20 50 61 72 73 65 72 41 63 74 69 6f 6e 20  pe ParserAction 
1cb0: 3d 20 28 6d 61 74 63 68 65 64 54 65 78 74 3a 20  = (matchedText: 
1cc0: 73 74 72 69 6e 67 2c 20 6f 75 74 70 75 74 3a 20  string, output: 
1cd0: 50 61 72 73 65 72 4f 75 74 70 75 74 29 20 3d 26  ParserOutput) =&
1ce0: 67 74 3b 20 50 61 72 73 65 72 4f 75 74 70 75 74  gt; ParserOutput
1cf0: 3b 3c 2f 66 6f 6e 74 3e 3c 2f 70 72 65 3e 0a 0a  ;</font></pre>..
1d00: 3c 70 3e 3c 66 6f 6e 74 20 66 61 63 65 3d 22 41  <p><font face="A
1d10: 72 69 61 6c 22 20 73 69 7a 65 3d 22 33 22 3e 49  rial" size="3">I
1d20: 74 20 69 73 20 61 20 66 75 6e 63 74 69 6f 6e 20  t is a function 
1d30: 74 68 61 74 20 74 61 6b 65 73 20 74 77 6f 20 70  that takes two p
1d40: 61 72 61 6d 65 74 65 72 73 3a 20 3c 69 3e 6d 61  arameters: <i>ma
1d50: 74 63 68 65 64 54 65 78 74 2c 3c 2f 69 3e 26 6e  tchedText,</i>&n
1d60: 62 73 70 3b 61 6e 64 0a 3c 69 3e 6f 75 74 70 75  bsp;and.<i>outpu
1d70: 74 2e 3c 2f 69 3e 26 6e 62 73 70 3b 54 68 65 20  t.</i>&nbsp;The 
1d80: 66 69 72 73 74 20 68 6f 6c 64 73 20 74 68 65 20  first holds the 
1d90: 61 63 74 75 61 6c 20 74 65 78 74 20 74 68 61 74  actual text that
1da0: 20 77 61 73 20 6d 61 74 63 68 65 64 20 62 79 20   was matched by 
1db0: 74 68 65 0a 70 61 72 73 65 72 2e 20 54 68 69 73  the.parser. This
1dc0: 20 6d 61 79 20 73 65 65 6d 20 74 72 69 76 69 61   may seem trivia
1dd0: 6c 3b 20 61 66 74 65 72 20 61 6c 6c 20 79 6f 75  l; after all you
1de0: 20 61 72 65 20 61 74 74 61 63 68 69 6e 67 20 74   are attaching t
1df0: 68 65 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 61  he function to a
1e00: 0a 70 61 72 73 65 72 20 61 6e 64 20 79 6f 75 20  .parser and you 
1e10: 6b 6e 6f 77 20 77 68 61 74 20 74 68 65 20 70 61  know what the pa
1e20: 72 73 65 72 20 6d 61 74 63 68 65 73 2c 20 72 69  rser matches, ri
1e30: 67 68 74 3f 20 57 65 6c 6c 2c 20 61 20 3c 69 3e  ght? Well, a <i>
1e40: 50 61 72 73 65 72 41 63 74 69 6f 6e 3c 2f 69 3e  ParserAction</i>
1e50: 26 6e 62 73 70 3b 63 61 6e 0a 62 65 20 61 74 74  &nbsp;can.be att
1e60: 61 63 68 65 64 20 74 6f 20 61 20 70 61 72 73 65  ached to a parse
1e70: 72 20 6f 66 20 61 72 62 69 74 72 61 72 79 20 63  r of arbitrary c
1e80: 6f 6d 70 6c 65 78 69 74 79 2c 20 61 6e 64 20 69  omplexity, and i
1e90: 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 68  t is possible th
1ea0: 61 74 20 6f 6e 65 20 6f 66 0a 76 65 72 79 20 6d  at one of.very m
1eb0: 61 6e 79 20 64 69 66 66 65 72 65 6e 74 20 70 61  any different pa
1ec0: 74 74 65 72 6e 73 20 77 69 6c 6c 20 68 61 76 65  tterns will have
1ed0: 20 62 65 65 6e 20 6d 61 74 63 68 65 64 2c 20 73   been matched, s
1ee0: 6f 20 6b 6e 6f 77 69 6e 67 20 77 68 61 74 20 77  o knowing what w
1ef0: 61 73 0a 6d 61 74 63 68 65 64 20 69 73 20 6e 65  as.matched is ne
1f00: 63 65 73 73 61 72 79 20 66 6f 72 20 77 72 69 74  cessary for writ
1f10: 69 6e 67 20 61 6e 79 74 68 69 6e 67 20 6f 74 68  ing anything oth
1f20: 65 72 20 74 68 61 6e 20 74 68 65 20 6d 6f 73 74  er than the most
1f30: 20 74 72 69 76 69 61 6c 20 66 75 6e 63 74 69 6f   trivial functio
1f40: 6e 2e 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c  n.</font></p>..<
1f50: 70 3e 3c 66 6f 6e 74 20 66 61 63 65 3d 22 41 72  p><font face="Ar
1f60: 69 61 6c 22 20 73 69 7a 65 3d 22 33 22 3e 54 68  ial" size="3">Th
1f70: 65 20 3c 69 3e 6f 75 74 70 75 74 3c 2f 69 3e 26  e <i>output</i>&
1f80: 6e 62 73 70 3b 70 61 72 61 6d 65 74 65 72 20 69  nbsp;parameter i
1f90: 73 20 74 68 65 20 63 75 72 72 65 6e 74 0a 73 74  s the current.st
1fa0: 61 74 65 20 6f 66 20 74 68 65 20 70 61 72 73 65  ate of the parse
1fb0: 3a 20 61 6c 6c 20 6f 66 20 74 68 65 20 74 65 78  : all of the tex
1fc0: 74 73 20 6d 61 74 63 68 65 64 20 74 6f 20 64 61  ts matched to da
1fd0: 74 65 20 61 73 20 77 65 6c 6c 20 61 73 20 77 68  te as well as wh
1fe0: 61 74 65 76 65 72 0a 61 70 70 6c 69 63 61 74 69  atever.applicati
1ff0: 6f 6e 2d 73 70 65 63 69 66 69 63 20 64 61 74 61  on-specific data
2000: 20 68 61 73 20 62 65 65 6e 20 63 6f 6c 6c 65 63   has been collec
2010: 74 65 64 2e 20 59 6f 75 20 63 61 6e 20 73 65 65  ted. You can see
2020: 20 74 68 61 74 20 74 68 65 20 66 69 72 73 74 20   that the first 
2030: 74 68 69 6e 67 0a 74 68 61 74 20 74 68 65 20 66  thing.that the f
2040: 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 69 73 20  unction does is 
2050: 63 72 65 61 74 65 20 6f 66 20 63 6f 70 79 20 6f  create of copy o
2060: 66 20 74 68 61 74 20 77 68 69 63 68 20 69 73 20  f that which is 
2070: 70 61 73 73 65 64 20 69 6e 2c 20 61 6e 64 20 69  passed in, and i
2080: 74 0a 6d 61 6b 65 73 20 61 6c 6c 20 63 68 61 6e  t.makes all chan
2090: 67 65 73 20 74 6f 20 61 6e 64 20 72 65 74 75 72  ges to and retur
20a0: 6e 73 20 74 68 61 74 20 63 6f 70 79 2e 3c 2f 66  ns that copy.</f
20b0: 6f 6e 74 3e 3c 2f 70 3e 0a 0a 3c 70 3e 3c 66 6f  ont></p>..<p><fo
20c0: 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c 22 20  nt face="Arial" 
20d0: 73 69 7a 65 3d 22 33 22 3e 54 68 65 20 66 75 6e  size="3">The fun
20e0: 63 74 69 6f 6e 20 6d 61 74 63 68 65 73 20 6f 75  ction matches ou
20f0: 72 20 65 78 70 65 63 74 65 64 20 76 61 6c 75 65  r expected value
2100: 20 6f 66 20 3c 69 3e 2b 3c 2f 69 3e 2c 0a 62 75   of <i>+</i>,.bu
2110: 74 20 69 74 20 61 6c 73 6f 20 6b 6e 6f 77 73 20  t it also knows 
2120: 61 62 6f 75 74 20 74 68 65 20 73 79 6e 6f 6e 79  about the synony
2130: 6d 20 3c 69 3e 70 6c 75 73 3c 2f 69 3e 26 6e 62  m <i>plus</i>&nb
2140: 73 70 3b 61 6e 64 20 61 6c 6c 20 74 68 65 20 6f  sp;and all the o
2150: 74 68 65 72 0a 6f 70 65 72 61 74 6f 72 73 20 61  ther.operators a
2160: 6e 64 20 74 68 65 69 72 20 73 79 6e 6f 6e 79 6d  nd their synonym
2170: 73 2e 20 48 6f 77 65 76 65 72 2c 20 77 65 20 68  s. However, we h
2180: 61 76 65 6e 27 74 20 79 65 74 20 77 72 69 74 74  aven't yet writt
2190: 65 6e 20 61 20 70 61 72 73 65 72 20 74 68 61 74  en a parser that
21a0: 0a 77 69 6c 6c 20 6d 61 74 63 68 20 61 6e 79 20  .will match any 
21b0: 6f 66 20 74 68 6f 73 65 2e 20 46 69 72 73 74 2c  of those. First,
21c0: 20 6c 65 74 27 73 20 72 65 77 72 69 74 65 20 6f   let's rewrite o
21d0: 75 72 20 64 65 66 69 6e 69 74 69 6f 6e 20 6f 66  ur definition of
21e0: 20 3c 69 3e 6f 70 65 72 61 6e 64 50 6c 75 73 3c   <i>operandPlus<
21f0: 2f 69 3e 26 6e 62 73 70 3b 73 6f 0a 74 68 65 20  /i>&nbsp;so.the 
2200: 61 63 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20 63  action will be c
2210: 61 6c 6c 65 64 3a 3c 2f 66 6f 6e 74 3e 3c 2f 70  alled:</font></p
2220: 3e 0a 3c 70 72 65 3e 3c 66 6f 6e 74 20 73 69 7a  >.<pre><font siz
2230: 65 3d 22 33 22 20 66 61 63 65 3d 22 43 6f 75 72  e="3" face="Cour
2240: 69 65 72 20 4e 65 77 22 3e 6c 65 74 20 6f 70 65  ier New">let ope
2250: 72 61 6e 64 50 6c 75 73 3a 20 70 63 6f 6d 62 2e  randPlus: pcomb.
2260: 50 61 72 73 65 72 20 3d 20 70 3c 2f 66 6f 6e 74  Parser = p</font
2270: 3e 3c 66 6f 6e 74 20 66 61 63 65 3d 22 43 6f 75  ><font face="Cou
2280: 72 69 65 72 20 4e 65 77 22 3e 3c 66 6f 6e 74 20  rier New"><font 
2290: 73 69 7a 65 3d 22 33 22 3e 63 6f 6d 62 2e 6c 69  size="3">comb.li
22a0: 74 28 22 2b 22 2c 20 74 68 69 73 2e 6f 70 65 72  t("+", this.oper
22b0: 61 6e 64 53 65 74 29 3b 3c 2f 66 6f 6e 74 3e 3c  andSet);</font><
22c0: 2f 66 6f 6e 74 3e 3c 2f 70 72 65 3e 0a 0a 3c 70  /font></pre>..<p
22d0: 3e 3c 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69  ><font face="Ari
22e0: 61 6c 22 20 73 69 7a 65 3d 22 33 22 3e 4e 6f 77  al" size="3">Now
22f0: 20 77 65 20 63 61 6e 20 72 65 77 72 69 74 65 20   we can rewrite 
2300: 6f 75 72 20 70 61 72 73 65 72 20 73 6f 20 74 68  our parser so th
2310: 61 74 20 69 74 20 77 69 6c 6c 0a 6d 61 74 63 68  at it will.match
2320: 20 65 69 74 68 65 72 20 3c 69 3e 2b 3c 2f 69 3e   either <i>+</i>
2330: 26 6e 62 73 70 3b 6f 72 20 3c 69 3e 70 6c 75 73  &nbsp;or <i>plus
2340: 3c 2f 69 3e 3a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e  </i>:</font></p>
2350: 0a 3c 70 72 65 3e 3c 66 6f 6e 74 20 73 69 7a 65  .<pre><font size
2360: 3d 22 33 22 20 66 61 63 65 3d 22 43 6f 75 72 69  ="3" face="Couri
2370: 65 72 20 4e 65 77 22 3e 3c 73 70 61 6e 20 73 74  er New"><span st
2380: 79 6c 65 3d 22 66 6f 6e 74 2d 73 69 7a 65 3a 20  yle="font-size: 
2390: 6d 65 64 69 75 6d 3b 20 63 6f 6c 6f 72 3a 20 72  medium; color: r
23a0: 67 62 28 31 37 2c 20 31 37 2c 20 31 37 29 3b 22  gb(17, 17, 17);"
23b0: 3e 6c 65 74 20 6f 70 65 72 61 6e 64 50 6c 75 73  >let operandPlus
23c0: 3a 20 70 63 6f 6d 62 2e 50 61 72 73 65 72 20 3d  : pcomb.Parser =
23d0: 26 6e 62 73 70 3b 3c 2f 73 70 61 6e 3e 70 63 6f  &nbsp;</span>pco
23e0: 6d 62 2e 6f 72 28 5b 70 63 6f 6d 62 2e 6c 69 74  mb.or([pcomb.lit
23f0: 28 22 2b 22 2c 20 74 68 69 73 2e 6f 70 65 72 61  ("+", this.opera
2400: 6e 64 53 65 74 29 2c 20 70 63 6f 6d 62 2e 6c 69  ndSet), pcomb.li
2410: 74 28 22 70 6c 75 73 22 2c 20 74 68 69 73 2e 6f  t("plus", this.o
2420: 70 65 72 61 6e 64 53 65 74 29 5d 29 3b 3c 2f 66  perandSet)]);</f
2430: 6f 6e 74 3e 3c 2f 70 72 65 3e 0a 0a 3c 70 3e 3c  ont></pre>..<p><
2440: 66 6f 6e 74 20 66 61 63 65 3d 22 41 72 69 61 6c  font face="Arial
2450: 22 20 73 69 7a 65 3d 22 33 22 3e 53 69 6e 63 65  " size="3">Since
2460: 20 74 68 65 20 3c 69 3e 6f 72 3c 2f 69 3e 26 6e   the <i>or</i>&n
2470: 62 73 70 3b 63 6f 6d 62 69 6e 61 74 6f 72 20 63  bsp;combinator c
2480: 61 6e 20 74 61 6b 65 20 61 0a 3c 69 3e 50 61 72  an take a.<i>Par
2490: 73 65 72 41 63 74 69 6f 6e 2c 3c 2f 69 3e 26 6e  serAction,</i>&n
24a0: 62 73 70 3b 77 65 20 63 61 6e 20 72 65 77 72 69  bsp;we can rewri
24b0: 74 65 20 74 68 65 20 61 62 6f 76 65 20 74 6f 20  te the above to 
24c0: 65 6c 69 6d 69 6e 61 74 65 20 72 65 64 75 6e 64  eliminate redund
24d0: 61 6e 63 79 3a 3c 2f 66 6f 6e 74 3e 3c 2f 70 3e  ancy:</font></p>
24e0: 0a 0a 5a 20 66 37 61 64 66 31 66 39 65 34 39 63  ..Z f7adf1f9e49c
24f0: 37 36 64 30 64 38 63 61 31 30 62 64 36 63 39 34  76d0d8ca10bd6c94
2500: 64 38 32 39 0a                                   d829.