parse0x  Hex Artifact Content

Artifact 19d6f8d00890364d5bfed8ccd8a3c87283eb37d7:

Wiki page [parse0x] by stephan 2008-05-23 22:04:51.
0000: 44 20 32 30 30 38 2d 30 35 2d 32 33 54 32 32 3a  D 2008-05-23T22:
0010: 30 34 3a 35 31 0a 4c 20 70 61 72 73 65 30 78 0a  04:51.L parse0x.
0020: 50 20 32 35 30 65 63 32 39 62 63 39 36 32 61 62  P 250ec29bc962ab
0030: 39 30 62 30 36 64 37 37 62 64 61 30 36 61 66 31  90b06d77bda06af1
0040: 33 35 37 33 39 65 35 63 39 35 0a 55 20 73 74 65  35739e5c95.U ste
0050: 70 68 61 6e 0a 57 20 33 36 32 37 0a 3c 63 65 6e  phan.W 3627.<cen
0060: 74 65 72 3e 3c 68 31 3e 70 61 72 73 65 30 78 3a  ter><h1>parse0x:
0070: 20 43 2b 2b 30 78 20 70 61 72 73 65 72 20 67 65   C++0x parser ge
0080: 6e 65 72 61 74 6f 72 20 74 6f 6f 6c 6b 69 74 3c  nerator toolkit<
0090: 2f 68 31 3e 3c 2f 63 65 6e 74 65 72 3e 0d 0a 0d  /h1></center>...
00a0: 0a 3c 63 65 6e 74 65 72 3e 3c 65 6d 3e 22 4f 6e  .<center><em>"On
00b0: 6c 69 6e 65 20 73 69 6e 63 65 20 4d 61 79 20 32  line since May 2
00c0: 30 30 38 21 22 3c 2f 65 6d 3e 3c 2f 63 65 6e 74  008!"</em></cent
00d0: 65 72 3e 0d 0a 0d 0a 70 61 72 73 65 30 78 20 69  er>....parse0x i
00e0: 73 20 61 6e 20 3c 65 6d 3e 65 78 70 65 72 69 6d  s an <em>experim
00f0: 65 6e 74 61 6c 3c 2f 65 6d 3e 20 70 61 72 73 65  ental</em> parse
0100: 72 20 74 6f 6f 6c 6b 69 74 20 66 6f 72 20 43 2b  r toolkit for C+
0110: 2b 30 78 2d 63 6f 6d 70 6c 69 61 6e 74 0d 0a 43  +0x-compliant..C
0120: 2b 2b 20 63 6f 6d 70 69 6c 65 72 73 2c 20 63 6f  ++ compilers, co
0130: 6e 63 65 70 74 75 61 6c 6c 79 20 62 61 73 65 64  nceptually based
0140: 20 76 65 72 79 20 6d 75 63 68 20 6f 6e 0d 0a 5b   very much on..[
0150: 68 74 74 70 3a 2f 2f 63 6f 64 65 2e 67 6f 6f 67  http://code.goog
0160: 6c 65 2e 63 6f 6d 2f 70 2f 70 65 67 74 6c 7c 44  le.com/p/pegtl|D
0170: 72 2e 20 43 6f 6c 69 6e 20 48 69 72 73 63 68 27  r. Colin Hirsch'
0180: 73 20 50 45 47 54 4c 20 6c 69 62 72 61 72 79 5d  s PEGTL library]
0190: 2c 0d 0a 62 75 74 20 73 74 72 69 70 70 65 64 20  ,..but stripped 
01a0: 6f 66 20 74 68 65 20 65 72 72 6f 72 20 72 65 70  of the error rep
01b0: 6f 72 74 69 6e 67 20 66 61 63 69 6c 69 74 69 65  orting facilitie
01c0: 73 20 74 68 61 74 20 6c 69 62 72 61 72 79 20 68  s that library h
01d0: 61 73 2e 0d 0a 28 54 68 69 73 20 6d 61 6b 65 73  as...(This makes
01e0: 20 69 74 20 6d 75 63 68 20 73 6d 61 6c 6c 65 72   it much smaller
01f0: 20 61 6e 64 20 73 6f 6d 65 77 68 61 74 20 65 61   and somewhat ea
0200: 73 69 65 72 20 74 6f 20 65 78 74 65 6e 64 2c 20  sier to extend, 
0210: 62 75 74 20 61 6c 73 6f 20 6e 6f 74 20 74 65 72  but also not ter
0220: 72 69 62 6c 79 0d 0a 75 73 65 66 75 6c 20 66 6f  ribly..useful fo
0230: 72 20 74 72 61 63 6b 69 6e 67 20 70 61 72 73 69  r tracking parsi
0240: 6e 67 20 65 72 72 6f 72 73 2e 29 20 49 74 20 69  ng errors.) It i
0250: 73 20 73 69 6d 69 6c 61 72 20 74 6f 20 6c 69 62  s similar to lib
0260: 72 61 72 69 65 73 20 6c 69 6b 65 0d 0a 5b 68 74  raries like..[ht
0270: 74 70 3a 2f 2f 73 70 69 72 69 74 2e 73 66 2e 6e  tp://spirit.sf.n
0280: 65 74 7c 42 6f 6f 73 74 2e 53 70 69 72 69 74 5d  et|Boost.Spirit]
0290: 20 62 75 74 20 69 73 20 6d 75 63 68 2c 20 6d 75   but is much, mu
02a0: 63 68 20 73 6d 61 6c 6c 65 72 20 69 6e 0d 0a 73  ch smaller in..s
02b0: 63 6f 70 65 2e 20 49 74 20 72 65 71 75 69 72 65  cope. It require
02c0: 73 20 43 2b 2b 30 78 20 73 75 70 70 6f 72 74 2c  s C++0x support,
02d0: 20 77 68 69 63 68 20 69 73 20 63 75 72 72 65 6e   which is curren
02e0: 74 6c 79 20 6f 6e 6c 79 20 61 76 61 69 6c 61 62  tly only availab
02f0: 6c 65 0d 0a 5b 68 74 74 70 3a 2f 2f 67 63 63 2e  le..[http://gcc.
0300: 67 6e 75 2e 6f 72 67 2f 70 72 6f 6a 65 63 74 73  gnu.org/projects
0310: 2f 63 78 78 30 78 2e 68 74 6d 6c 7c 69 6e 20 62  /cxx0x.html|in b
0320: 65 74 61 20 66 6f 72 6d 5d 2e 20 54 72 79 20 5b  eta form]. Try [
0330: 68 74 74 70 3a 2f 2f 67 63 63 2e 67 6e 75 2e 6f  http://gcc.gnu.o
0340: 72 67 2f 67 63 63 2d 34 2e 33 2f 7c 67 63 63 20  rg/gcc-4.3/|gcc 
0350: 34 2e 33 5d 2e 0d 0a 0d 0a 70 61 72 73 65 30 78  4.3].....parse0x
0360: 20 69 73 20 62 65 6c 69 65 76 65 64 20 74 6f 20   is believed to 
0370: 63 6f 6e 66 6f 72 6d 20 74 6f 20 74 68 65 20 72  conform to the r
0380: 75 6c 65 73 20 6f 66 20 50 61 72 73 69 6e 67 20  ules of Parsing 
0390: 45 78 70 72 65 73 73 69 6f 6e 20 47 72 61 6d 6d  Expression Gramm
03a0: 61 72 73 20 28 50 45 47 73 29 2c 20 61 73 0d 0a  ars (PEGs), as..
03b0: 64 65 74 61 69 6c 65 64 20 6f 6e 20 74 68 69 73  detailed on this
03c0: 20 0d 0a 5b 68 74 74 70 3a 2f 2f 65 6e 2e 77 69   ..[http://en.wi
03d0: 6b 69 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69  kipedia.org/wiki
03e0: 2f 50 61 72 73 69 6e 67 5f 65 78 70 72 65 73 73  /Parsing_express
03f0: 69 6f 6e 5f 67 72 61 6d 6d 61 72 7c 57 69 6b 69  ion_grammar|Wiki
0400: 70 65 64 69 61 20 70 61 67 65 20 61 62 6f 75 74  pedia page about
0410: 20 50 45 47 73 5d 0d 0a 28 74 68 6f 75 67 68 20   PEGs]..(though 
0420: 74 68 65 20 66 6f 72 6d 61 6c 69 74 69 65 73 20  the formalities 
0430: 6f 66 20 69 74 20 61 72 65 20 61 64 6d 69 74 74  of it are admitt
0440: 65 64 6c 79 20 6f 76 65 72 20 6d 79 20 68 65 61  edly over my hea
0450: 64 29 2e 0d 0a 0d 0a 54 68 69 73 20 70 61 63 6b  d).....This pack
0460: 61 67 65 27 73 20 68 6f 6d 65 20 70 61 67 65 20  age's home page 
0470: 69 73 3a 0d 0a 0d 0a 5b 68 74 74 70 3a 2f 2f 77  is:....[http://w
0480: 61 6e 64 65 72 69 6e 67 68 6f 72 73 65 2e 6e 65  anderinghorse.ne
0490: 74 2f 63 6f 6d 70 75 74 69 6e 67 2f 70 61 72 73  t/computing/pars
04a0: 65 30 78 5d 0d 0a 0d 0a 3c 68 32 3e 4c 69 63 65  e0x]....<h2>Lice
04b0: 6e 73 65 3c 2f 68 32 3e 0d 0a 0d 0a 54 68 69 73  nse</h2>....This
04c0: 20 73 6f 75 72 63 65 20 63 6f 64 65 20 69 73 20   source code is 
04d0: 72 65 6c 65 61 73 65 64 20 69 6e 74 6f 20 74 68  released into th
04e0: 65 20 50 75 62 6c 69 63 20 44 6f 6d 61 69 6e 20  e Public Domain 
04f0: 62 79 20 69 74 73 20 61 75 74 68 6f 72 2c 0d 0a  by its author,..
0500: 53 74 65 70 68 61 6e 20 42 65 61 6c 20 28 5b 68  Stephan Beal ([h
0510: 74 74 70 3a 2f 2f 77 61 6e 64 65 72 69 6e 67 68  ttp://wanderingh
0520: 6f 72 73 65 2e 6e 65 74 2f 68 6f 6d 65 2f 73 74  orse.net/home/st
0530: 65 70 68 61 6e 2f 5d 29 2e 20 54 68 61 74 20 69  ephan/]). That i
0540: 73 2c 20 79 6f 75 20 6d 61 79 0d 0a 74 61 6b 65  s, you may..take
0550: 20 69 74 20 61 6e 64 20 75 73 65 20 69 74 20 66   it and use it f
0560: 6f 72 20 61 6e 79 20 70 75 72 70 6f 73 65 20 77  or any purpose w
0570: 68 61 74 73 6f 65 76 65 72 2c 20 63 6f 6d 6d 65  hatsoever, comme
0580: 72 63 69 61 6c 20 6f 72 20 6f 74 68 65 72 77 69  rcial or otherwi
0590: 73 65 2e 0d 0a 0d 0a 3c 68 32 3e 45 78 61 6d 70  se.....<h2>Examp
05a0: 6c 65 73 3c 2f 68 32 3e 0d 0a 0d 0a 54 68 65 20  les</h2>....The 
05b0: 73 6f 75 72 63 65 20 74 72 65 65 20 63 6f 6d 65  source tree come
05c0: 73 20 77 69 74 68 20 61 20 74 65 73 74 20 61 70  s with a test ap
05d0: 70 20 28 74 65 73 74 2e 63 70 70 29 20 77 68 69  p (test.cpp) whi
05e0: 63 68 20 73 68 6f 77 73 20 68 6f 77 20 74 6f 0d  ch shows how to.
05f0: 0a 64 6f 20 74 68 69 6e 67 73 20 6c 69 6b 65 20  .do things like 
0600: 70 61 72 73 65 20 49 50 20 61 64 64 72 65 73 73  parse IP address
0610: 65 73 2c 20 73 74 72 69 6e 67 20 6c 69 74 65 72  es, string liter
0620: 61 6c 73 2c 20 61 6e 64 20 76 61 72 69 6f 75 73  als, and various
0630: 20 6e 75 6d 65 72 69 63 0d 0a 74 79 70 65 73 2e   numeric..types.
0640: 20 54 68 65 72 65 20 69 73 20 61 6c 73 6f 20 74   There is also t
0650: 68 61 74 20 6d 6f 73 74 20 63 6c 61 73 73 69 63  hat most classic
0660: 20 6f 66 20 70 61 72 73 69 6e 67 20 65 78 61 6d   of parsing exam
0670: 70 6c 65 73 2c 20 61 20 63 61 6c 63 75 6c 61 74  ples, a calculat
0680: 6f 72 2e 0d 0a 0d 0a 41 73 69 64 65 20 66 72 6f  or.....Aside fro
0690: 6d 20 74 68 65 20 65 78 61 6d 70 6c 65 20 63 6f  m the example co
06a0: 64 65 20 77 65 20 68 61 76 65 0d 0a 5b 49 6e 74  de we have..[Int
06b0: 72 6f 54 6f 50 61 72 73 65 30 78 7c 61 20 76 65  roToParse0x|a ve
06c0: 72 79 2d 6d 75 63 68 2d 75 6e 66 69 6e 69 73 68  ry-much-unfinish
06d0: 65 64 20 69 6e 74 72 6f 64 75 63 74 69 6f 6e 20  ed introduction 
06e0: 74 6f 20 70 61 72 73 65 30 78 5d 0d 0a 61 6e 64  to parse0x]..and
06f0: 20 5b 52 75 6c 65 73 4f 76 65 72 76 69 65 77 7c   [RulesOverview|
0700: 61 6e 20 6f 76 65 72 76 69 65 77 20 6f 66 20 74  an overview of t
0710: 68 65 20 62 75 69 6c 74 2d 69 6e 20 70 61 72 73  he built-in pars
0720: 69 6e 67 20 72 75 6c 65 73 5d 2e 0d 0a 0d 0a 3c  ing rules].....<
0730: 68 32 3e 46 65 61 74 75 72 65 73 3c 2f 68 32 3e  h2>Features</h2>
0740: 0d 0a 0d 0a 3c 75 6c 3e 0d 0a 3c 6c 69 3e 41 6c  ....<ul>..<li>Al
0750: 6c 6f 77 73 20 63 72 65 61 74 69 6f 6e 20 6f 66  lows creation of
0760: 20 70 61 72 73 65 72 73 20 75 73 69 6e 67 20 52   parsers using R
0770: 75 6c 65 73 2c 20 77 68 69 63 68 20 61 72 65 0d  ules, which are.
0780: 0a 73 6d 61 6c 6c 20 63 6c 61 73 73 65 73 20 77  .small classes w
0790: 68 69 63 68 20 69 6d 70 6c 65 6d 65 6e 74 20 73  hich implement s
07a0: 74 72 69 6e 67 2d 6d 61 74 63 68 69 6e 67 20 72  tring-matching r
07b0: 75 6c 65 73 2e 20 52 75 6c 65 73 0d 0a 63 61 6e  ules. Rules..can
07c0: 20 62 65 20 63 6f 6d 62 69 6e 65 64 20 74 6f 20   be combined to 
07d0: 63 72 65 61 74 65 20 70 61 72 73 65 72 73 20 6f  create parsers o
07e0: 66 20 6e 65 61 72 6c 79 20 61 72 62 69 74 72 61  f nearly arbitra
07f0: 72 79 0d 0a 63 6f 6d 70 6c 65 78 69 74 79 2e 20  ry..complexity. 
0800: 52 75 6c 65 73 20 68 61 76 65 20 6e 6f 20 6c 6f  Rules have no lo
0810: 63 61 6c 20 73 74 61 74 65 20 61 6e 64 20 61 72  cal state and ar
0820: 65 20 6e 65 76 65 72 20 69 6e 73 74 61 6e 74 69  e never instanti
0830: 61 74 65 64 2c 0d 0a 73 6f 20 74 68 65 79 27 72  ated,..so they'r
0840: 65 20 6d 65 6d 6f 72 79 2d 6c 69 67 68 74 2e 3c  e memory-light.<
0850: 2f 6c 69 3e 0d 0a 3c 6c 69 3e 54 68 65 72 65 20  /li>..<li>There 
0860: 61 72 65 20 6e 6f 20 73 65 70 61 72 61 74 65 20  are no separate 
0870: 74 6f 6b 65 6e 69 7a 61 74 69 6f 6e 20 61 6e 64  tokenization and
0880: 20 70 61 72 73 65 20 70 68 61 73 65 73 20 2d 20   parse phases - 
0890: 74 68 65 79 27 72 65 0d 0a 63 6f 6d 62 69 6e 65  they're..combine
08a0: 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  d into a single 
08b0: 70 68 61 73 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  phase.</li>..<li
08c0: 3e 56 61 6c 69 64 61 74 69 6e 67 2d 6f 6e 6c 79  >Validating-only
08d0: 20 70 61 72 73 65 72 73 20 28 74 68 61 74 20 69   parsers (that i
08e0: 73 2c 20 77 69 74 68 6f 75 74 20 61 6e 79 20 63  s, without any c
08f0: 6c 69 65 6e 74 2d 73 69 64 65 20 61 63 74 69 6f  lient-side actio
0900: 6e 73 29 0d 0a 63 61 6e 20 6e 6f 72 6d 61 6c 6c  ns)..can normall
0910: 79 20 62 65 20 69 6d 70 6c 65 6d 65 6e 74 65 64  y be implemented
0920: 20 75 73 69 6e 67 20 6f 6e 6c 79 20 74 79 70 65   using only type
0930: 64 65 66 73 20 6f 72 20 65 6d 70 74 79 20 73 74  defs or empty st
0940: 72 75 63 74 73 0d 0a 77 68 69 63 68 20 69 6e 68  ructs..which inh
0950: 65 72 69 74 20 6f 74 68 65 72 20 72 75 6c 65 73  erit other rules
0960: 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 41 63 74 69  .</li>..<li>Acti
0970: 6f 6e 73 20 63 61 6e 20 62 65 20 74 69 65 64 20  ons can be tied 
0980: 74 6f 20 61 6e 79 20 52 75 6c 65 73 2c 20 74 6f  to any Rules, to
0990: 20 68 61 6e 64 6c 65 20 74 65 78 74 20 61 20 52   handle text a R
09a0: 75 6c 65 20 6d 61 74 63 68 65 73 2e 3c 2f 6c 69  ule matches.</li
09b0: 3e 0d 0a 3c 6c 69 3e 50 61 73 73 65 73 20 61 20  >..<li>Passes a 
09c0: 63 6c 69 65 6e 74 2d 64 65 66 69 6e 65 64 20 53  client-defined S
09d0: 74 61 74 65 20 74 79 70 65 20 74 6f 20 52 75 6c  tate type to Rul
09e0: 65 73 20 61 6e 64 20 41 63 74 69 6f 6e 73 2c 20  es and Actions, 
09f0: 73 6f 20 74 68 61 74 0d 0a 63 75 73 74 6f 6d 20  so that..custom 
0a00: 52 75 6c 65 73 2f 41 63 74 69 6f 6e 73 20 63 61  Rules/Actions ca
0a10: 6e 20 6d 61 6e 69 70 75 6c 61 74 65 20 63 6c 69  n manipulate cli
0a20: 65 6e 74 2d 73 69 64 65 20 64 61 74 61 20 64 75  ent-side data du
0a30: 72 69 6e 67 20 74 68 65 20 70 61 72 73 69 6e 67  ring the parsing
0a40: 0d 0a 70 72 6f 63 65 73 73 2e 3c 2f 6c 69 3e 0d  ..process.</li>.
0a50: 0a 3c 6c 69 3e 41 20 73 6d 61 6c 6c 20 68 65 61  .<li>A small hea
0a60: 64 65 72 2d 6f 6e 6c 79 20 69 6d 70 6c 65 6d 65  der-only impleme
0a70: 6e 74 61 74 69 6f 6e 2e 20 54 68 65 20 77 68 6f  ntation. The who
0a80: 6c 65 20 63 6f 72 65 20 6c 69 62 72 61 72 79 20  le core library 
0a90: 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 0d 0a  is implemented..
0aa0: 69 6e 20 61 20 73 69 6e 67 6c 65 20 68 65 61 64  in a single head
0ab0: 65 72 20 66 69 6c 65 2c 20 70 6c 75 73 20 73 6f  er file, plus so
0ac0: 6d 65 20 6f 70 74 69 6f 6e 61 6c 20 68 65 61 64  me optional head
0ad0: 65 72 73 20 61 72 65 20 69 6e 63 6c 75 64 65 64  ers are included
0ae0: 20 66 6f 72 20 68 61 6e 64 6c 69 6e 67 0d 0a 73   for handling..s
0af0: 6f 6d 65 20 63 6f 6d 6d 6f 6e 20 70 61 72 73 69  ome common parsi
0b00: 6e 67 20 63 61 73 65 73 20 28 65 2e 67 2e 20 71  ng cases (e.g. q
0b10: 75 6f 74 65 64 20 73 74 72 69 6e 67 73 20 61 6e  uoted strings an
0b20: 64 20 69 70 76 34 20 61 64 64 72 65 73 73 65 73  d ipv4 addresses
0b30: 29 2e 20 54 68 65 20 63 6f 72 65 20 69 6d 70 6c  ). The core impl
0b40: 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 20 74 72  ementation is tr
0b50: 69 76 69 61 6c 2c 20 74 68 61 6e 6b 73 20 74 6f  ivial, thanks to
0b60: 20 43 2b 2b 30 78 27 73 20 76 61 72 69 61 64 69   C++0x's variadi
0b70: 63 20 74 65 6d 70 6c 61 74 65 73 20 66 65 61 74  c templates feat
0b80: 75 72 65 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 46  ure.</li>..<li>F
0b90: 61 69 72 6c 79 20 65 61 73 79 20 74 6f 20 75 73  airly easy to us
0ba0: 65 2c 20 61 74 20 6c 65 61 73 74 20 69 66 20 6f  e, at least if o
0bb0: 6e 65 20 69 73 20 66 61 6d 69 6c 69 61 72 20 77  ne is familiar w
0bc0: 69 74 68 20 74 65 6d 70 6c 61 74 65 2d 62 61 73  ith template-bas
0bd0: 65 64 0d 0a 70 72 6f 67 72 61 6d 69 6e 67 20 61  ed..programing a
0be0: 6e 64 20 77 72 69 74 69 6e 67 20 70 61 72 73 65  nd writing parse
0bf0: 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 2f 75 6c 3e 0d  rs.</li>..</ul>.
0c00: 0a 0d 0a 3c 68 32 3e 4d 69 73 66 65 61 74 75 72  ...<h2>Misfeatur
0c10: 65 73 3c 2f 68 32 3e 0d 0a 0d 0a 3c 75 6c 3e 0d  es</h2>....<ul>.
0c20: 0a 3c 6c 69 3e 52 65 71 75 69 72 65 73 20 43 2b  .<li>Requires C+
0c30: 2b 30 78 20 66 65 61 74 75 72 65 73 2c 20 77 68  +0x features, wh
0c40: 69 63 68 20 68 61 73 20 6f 6e 6c 79 20 6c 69 6d  ich has only lim
0c50: 69 74 65 64 20 73 75 70 70 6f 72 74 20 69 6e 20  ited support in 
0c60: 74 68 65 0d 0a 6e 65 77 65 73 74 20 63 6f 6d 70  the..newest comp
0c70: 69 6c 65 72 73 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69  ilers.</li>..<li
0c80: 3e 43 75 72 72 65 6e 74 6c 79 20 70 72 6f 76 69  >Currently provi
0c90: 64 65 73 20 6e 6f 20 77 61 79 20 6f 66 20 72 65  des no way of re
0ca0: 70 6f 72 74 69 6e 67 20 77 68 65 72 65 2f 77 68  porting where/wh
0cb0: 79 20 61 20 70 61 72 73 69 6e 67 20 65 72 72 6f  y a parsing erro
0cc0: 72 0d 0a 6f 63 63 75 72 73 2e 20 54 68 61 74 20  r..occurs. That 
0cd0: 69 73 2c 20 61 20 70 61 72 73 65 20 65 69 74 68  is, a parse eith
0ce0: 65 72 20 66 61 69 6c 73 20 6f 72 20 73 75 63 63  er fails or succ
0cf0: 65 65 64 73 2c 20 62 75 74 20 69 66 20 69 74 20  eeds, but if it 
0d00: 66 61 69 6c 73 0d 0a 74 68 65 72 65 27 73 20 6e  fails..there's n
0d10: 6f 20 77 61 79 20 74 6f 20 6b 6e 6f 77 20 77 68  o way to know wh
0d20: 79 20 77 69 74 68 6f 75 74 20 61 64 64 69 6e 67  y without adding
0d30: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 73 74   additional inst
0d40: 72 75 6d 65 6e 74 61 74 69 6f 6e 0d 0a 74 6f 20  rumentation..to 
0d50: 74 68 65 20 70 61 72 73 65 72 2e 3c 2f 6c 69 3e  the parser.</li>
0d60: 0d 0a 3c 6c 69 3e 4f 6e 6c 79 20 77 6f 72 6b 73  ..<li>Only works
0d70: 20 6f 6e 20 73 74 64 3a 3a 73 74 72 69 6e 67 20   on std::string 
0d80: 69 6e 70 75 74 2c 20 6d 65 61 6e 69 6e 67 20 74  input, meaning t
0d90: 68 61 74 20 77 68 65 6e 20 72 65 61 64 69 6e 67  hat when reading
0da0: 0d 0a 66 72 6f 6d 20 73 74 72 65 61 6d 73 20 79  ..from streams y
0db0: 6f 75 20 6d 75 73 74 20 62 75 66 66 65 72 20 74  ou must buffer t
0dc0: 68 65 20 77 68 6f 6c 65 20 73 74 72 65 61 6d 20  he whole stream 
0dd0: 69 6e 74 6f 20 61 20 73 74 72 69 6e 67 20 66 69  into a string fi
0de0: 72 73 74 2e 3c 2f 6c 69 3e 0d 0a 3c 6c 69 3e 57  rst.</li>..<li>W
0df0: 6f 6e 27 74 20 77 6f 72 6b 20 77 69 74 68 20 62  on't work with b
0e00: 69 6e 61 72 79 20 64 61 74 61 2c 20 61 73 20 69  inary data, as i
0e10: 74 20 72 65 6c 69 65 73 20 6f 6e 20 61 20 6e 75  t relies on a nu
0e20: 6c 6c 20 63 68 61 72 61 63 74 65 72 20 74 6f 0d  ll character to.
0e30: 0a 6d 61 72 6b 20 65 6f 66 2e 3c 2f 6c 69 3e 0d  .mark eof.</li>.
0e40: 0a 3c 2f 75 6c 3e 0d 0a 0d 0a 0d 0a 0d 0a 3c 68  .</ul>........<h
0e50: 32 3e 44 6f 77 6e 6c 6f 61 64 3c 2f 68 32 3e 0d  2>Download</h2>.
0e60: 0a 0d 0a 53 65 65 20 74 68 65 20 5b 64 6f 77 6e  ...See the [down
0e70: 6c 6f 61 64 7c 64 6f 77 6e 6c 6f 61 64 73 20 70  load|downloads p
0e80: 61 67 65 5d 2e 0d 0a 0a 5a 20 61 30 64 31 33 37  age]....Z a0d137
0e90: 38 38 63 30 32 36 37 39 61 65 64 31 63 31 34 39  88c02679aed1c149
0ea0: 31 63 65 61 37 64 36 30 62 64 0a                 1cea7d60bd.