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> 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 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 </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<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 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;"> </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> 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 > 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;
14b0: 20 26 6e 62 73 70 3b 20 6c 65 74 20 72 65 73 75 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 <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">
1530: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e &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; &nb
1580: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1590: 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20 22 2b ; 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">
15c0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 &
15d0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 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"> &
1610: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 nbsp; &nb
1620: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1630: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 ;
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"> &nb
1680: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1690: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 ;
16a0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 62 72 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;
16e0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 &
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"> &n
1720: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &nbs
1730: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b p;
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"> &nb
1770: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1780: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 ;
1790: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 72 65 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">
17e0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e &n
17f0: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &nbs
1800: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b p;
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; &nb
1840: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1850: 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20 22 2a ; 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">
1880: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 &
1890: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 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">
18d0: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e &n
18e0: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &nbs
18f0: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b p;
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"> 
1940: 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 ;
1950: 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e &n
1960: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &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 > &
19a0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 nbsp; &nb
19b0: 73 70 3b 20 26 6e 62 73 70 3b 20 63 61 73 65 20 sp; 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;
19f0: 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 &
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 &n
1a40: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &nbs
1a50: 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 3b p;
1a60: 20 26 6e 62 73 70 3b 20 72 65 73 75 6c 74 2e 6f 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 > &
1ab0: 6e 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 nbsp; &nb
1ac0: 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 70 sp;  
1ad0: 3b 20 26 6e 62 73 70 3b 20 62 72 65 61 6b 3b 0d ; 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"> &n
1b00: 62 73 70 3b 20 26 6e 62 73 70 3b 20 26 6e 62 73 bsp; &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 &n
1b80: 62 73 70 3b 20 26 6e 62 73 70 3b 20 72 65 74 75 bsp; 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 ">
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> 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> 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 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> 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 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 </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.