th1-sgb  Hex Artifact Content

Artifact 331a9ae8a276bfda247450332a612f6689c62af8:

Wiki page [th1-sgb] by stephan 2012-08-14 14:46:52.
0000: 44 20 32 30 31 32 2d 30 38 2d 31 34 54 31 34 3a  D 2012-08-14T14:
0010: 34 36 3a 35 32 2e 34 39 30 0a 4c 20 74 68 31 2d  46:52.490.L th1-
0020: 73 67 62 0a 50 20 30 30 61 62 36 31 66 30 33 61  sgb.P 00ab61f03a
0030: 37 32 65 35 63 63 31 34 33 38 63 33 65 64 34 32  72e5cc1438c3ed42
0040: 34 31 30 35 38 39 38 34 39 37 61 64 31 63 0a 55  4105898497ad1c.U
0050: 20 73 74 65 70 68 61 6e 0a 57 20 32 35 39 35 0a   stephan.W 2595.
0060: 54 68 69 73 20 69 73 20 74 68 65 20 73 6f 75 72  This is the sour
0070: 63 65 20 72 65 70 6f 20 66 6f 72 20 5b 68 74 74  ce repo for [htt
0080: 70 3a 2f 2f 77 61 6e 64 65 72 69 6e 67 68 6f 72  p://wanderinghor
0090: 73 65 2e 6e 65 74 2f 68 6f 6d 65 2f 73 74 65 70  se.net/home/step
00a0: 68 61 6e 2f 7c 73 74 65 70 68 61 6e 20 62 65 61  han/|stephan bea
00b0: 6c 5d 27 73 20 66 6f 72 6b 2f 61 64 61 70 74 61  l]'s fork/adapta
00c0: 74 69 6f 6e 20 6f 66 20 52 69 63 68 61 72 64 20  tion of Richard 
00d0: 48 69 70 70 27 73 20 54 48 31 20 20 28 22 54 65  Hipp's TH1  ("Te
00e0: 73 74 20 48 61 72 6e 65 73 73 20 31 22 29 20 73  st Harness 1") s
00f0: 63 72 69 70 74 20 6c 61 6e 67 75 61 67 65 20 65  cript language e
0100: 6e 67 69 6e 65 2c 20 6d 6f 72 65 20 6f 72 20 6c  ngine, more or l
0110: 65 73 73 20 61 73 20 69 74 20 65 78 69 73 74 65  ess as it existe
0120: 64 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 66 6f  d [http://www.fo
0130: 73 73 69 6c 2d 73 63 6d 2e 6f 72 67 2f 69 6e 64  ssil-scm.org/ind
0140: 65 78 2e 68 74 6d 6c 2f 69 6e 66 6f 2f 63 30 31  ex.html/info/c01
0150: 37 36 34 62 30 64 31 7c 61 74 20 74 68 69 73 20  764b0d1|at this 
0160: 70 6f 69 6e 74 20 69 6e 20 66 6f 73 73 69 6c 27  point in fossil'
0170: 73 20 68 69 73 74 6f 72 79 5d 2c 20 6d 69 6e 75  s history], minu
0180: 73 20 74 68 65 20 66 6f 73 73 69 6c 2d 73 70 65  s the fossil-spe
0190: 63 69 66 69 63 20 66 65 61 74 75 72 65 73 20 61  cific features a
01a0: 6e 64 20 72 65 66 61 63 74 6f 72 65 64 20 61 20  nd refactored a 
01b0: 74 69 6e 79 20 62 69 74 20 74 6f 20 6d 61 6b 65  tiny bit to make
01c0: 20 69 74 20 65 61 73 69 65 72 20 74 6f 20 75 73   it easier to us
01d0: 65 20 61 73 20 61 20 64 72 6f 70 2d 69 6e 20 69  e as a drop-in i
01e0: 6e 20 6f 74 68 65 72 20 70 72 6f 6a 65 63 74 73  n other projects
01f0: 2e 20 54 68 69 73 20 54 48 31 20 69 6d 70 6c 65  . This TH1 imple
0200: 6d 65 6e 74 61 74 69 6f 6e 20 68 61 73 20 6e 6f  mentation has no
0210: 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79 20 72   compatibility r
0220: 65 71 75 69 72 65 6d 65 6e 74 73 20 77 69 74 68  equirements with
0230: 20 69 74 73 20 6f 72 69 67 69 6e 20 69 6d 70 6c   its origin impl
0240: 65 6d 65 6e 74 61 74 69 6f 6e 20 61 6e 64 20 22  ementation and "
0250: 6d 69 67 68 74 22 20 65 76 65 6e 74 75 61 6c 6c  might" eventuall
0260: 79 20 63 68 61 6e 67 65 20 73 69 67 6e 69 66 69  y change signifi
0270: 63 61 6e 74 6c 79 20 66 72 6f 6d 20 46 6f 73 73  cantly from Foss
0280: 69 6c 27 73 20 76 65 72 73 69 6f 6e 2e 0d 0a 0d  il's version....
0290: 0a 54 48 31 20 69 73 20 61 6e 20 65 6d 62 65 64  .TH1 is an embed
02a0: 64 61 62 6c 65 20 54 43 4c 2d 6c 69 6b 65 20 6c  dable TCL-like l
02b0: 61 6e 67 75 61 67 65 2c 20 62 75 74 20 69 73 20  anguage, but is 
02c0: 61 20 6d 69 6e 69 2d 6c 61 6e 67 75 61 67 65 2e  a mini-language.
02d0: 20 49 74 20 68 61 73 20 6f 6e 6c 79 20 61 20 66   It has only a f
02e0: 65 77 20 62 75 69 6c 74 2d 69 6e 20 63 6f 6d 6d  ew built-in comm
02f0: 61 6e 64 73 2c 20 68 61 73 20 6e 6f 20 6a 75 73  ands, has no jus
0300: 74 2d 69 6e 2d 74 69 6d 65 20 63 6f 6d 70 69 6c  t-in-time compil
0310: 65 72 20 6f 72 20 73 75 63 68 20 66 61 6e 63 79  er or such fancy
0320: 20 62 65 6c 6c 73 20 61 6e 64 20 77 68 69 73 74   bells and whist
0330: 6c 65 73 2c 20 73 74 6f 72 65 73 20 61 6c 6c 20  les, stores all 
0340: 76 61 6c 75 65 73 20 61 73 20 73 74 72 69 6e 67  values as string
0350: 73 2c 20 61 6e 64 20 69 6e 74 65 72 6e 61 6c 6c  s, and internall
0360: 79 20 61 6c 6c 6f 63 61 74 65 73 2f 66 72 65 65  y allocates/free
0370: 73 20 6d 65 6d 6f 72 79 20 76 65 72 79 20 6f 66  s memory very of
0380: 74 65 6e 2e 20 49 74 20 69 73 20 3c 65 6d 3e 6e  ten. It is <em>n
0390: 6f 74 3c 2f 65 6d 3e 20 61 20 68 69 67 68 2d 70  ot</em> a high-p
03a0: 65 72 66 6f 72 6d 61 6e 63 65 20 73 6f 6c 75 74  erformance solut
03b0: 69 6f 6e 20 74 6f 20 79 6f 75 72 20 65 6d 62 65  ion to your embe
03c0: 64 64 65 64 20 73 63 72 69 70 74 69 6e 67 20 70  dded scripting p
03d0: 72 6f 62 6c 65 6d 73 2e 20 49 74 20 3c 65 6d 3e  roblems. It <em>
03e0: 69 73 3c 2f 65 6d 3e 20 61 6e 20 65 61 73 79 20  is</em> an easy 
03f0: 77 61 79 20 74 6f 20 71 75 69 63 6b 6c 79 20 63  way to quickly c
0400: 72 65 61 74 65 20 61 20 73 63 72 69 70 74 69 6e  reate a scriptin
0410: 67 20 41 50 49 20 66 6f 72 2c 20 65 2e 67 2e 2c  g API for, e.g.,
0420: 20 72 75 6e 6e 69 6e 67 20 6c 69 62 72 61 72 79   running library
0430: 2f 61 70 70 6c 69 63 61 74 69 6f 6e 20 74 65 73  /application tes
0440: 74 20 63 6f 64 65 20 28 77 68 69 63 68 20 69 73  t code (which is
0450: 20 77 68 61 74 20 69 74 20 77 61 73 20 6f 72 69   what it was ori
0460: 67 69 6e 61 6c 6c 79 20 64 65 73 69 67 6e 65 64  ginally designed
0470: 20 66 6f 72 20 2d 20 72 75 6e 6e 69 6e 67 20 5b   for - running [
0480: 68 74 74 70 3a 2f 2f 73 71 6c 69 74 65 2e 6f 72  http://sqlite.or
0490: 67 7c 73 71 6c 69 74 65 5d 20 74 65 73 74 73 20  g|sqlite] tests 
04a0: 6f 6e 20 53 79 6d 62 69 61 6e 20 4f 53 29 2e 0d  on Symbian OS)..
04b0: 0a 0d 0a 54 48 31 20 69 73 20 77 72 69 74 74 65  ...TH1 is writte
04c0: 6e 20 69 6e 20 41 4e 53 49 20 43 38 39 20 61 6e  n in ANSI C89 an
04d0: 64 20 22 73 68 6f 75 6c 64 22 20 63 6f 6d 70 69  d "should" compi
04e0: 6c 65 20 61 73 2d 69 73 20 6f 6e 20 61 6e 79 20  le as-is on any 
04f0: 43 38 39 20 70 6c 61 74 66 6f 72 6d 2e 20 49 74  C89 platform. It
0500: 20 72 65 71 75 69 72 65 73 20 6e 6f 20 65 73 6f   requires no eso
0510: 74 65 72 69 63 20 6f 72 20 6e 6f 6e 2d 73 74 61  teric or non-sta
0520: 6e 64 61 72 64 20 6c 61 6e 67 75 61 67 65 20 66  ndard language f
0530: 65 61 74 75 72 65 73 2e 20 42 75 69 6c 64 20 66  eatures. Build f
0540: 69 6c 65 73 20 61 72 65 20 70 72 6f 76 69 64 65  iles are provide
0550: 64 20 66 6f 72 20 47 4e 55 20 4d 61 6b 65 2e 20  d for GNU Make. 
0560: 54 68 65 79 20 61 73 73 75 6d 65 20 6f 6e 65 20  They assume one 
0570: 69 73 20 75 73 69 6e 67 20 67 63 63 20 62 75 74  is using gcc but
0580: 20 63 61 6e 20 62 65 20 75 73 65 64 20 77 69 74   can be used wit
0590: 68 20 6f 74 68 65 72 20 43 20 63 6f 6d 70 69 6c  h other C compil
05a0: 65 72 2f 6c 69 6e 6b 65 72 20 62 79 20 73 65 74  er/linker by set
05b0: 74 69 6e 67 20 74 68 65 20 43 43 2f 43 58 58 20  ting the CC/CXX 
05c0: 6d 61 6b 65 66 69 6c 65 20 76 61 72 73 2e 20 65  makefile vars. e
05d0: 2e 67 2e 20 3c 74 74 3e 6d 61 6b 65 20 43 43 3d  .g. <tt>make CC=
05e0: 63 6c 61 6e 67 20 43 58 58 3d 63 6c 61 6e 67 20  clang CXX=clang 
05f0: 43 46 4c 41 47 53 3d 22 2d 67 20 2d 57 61 6c 6c  CFLAGS="-g -Wall
0600: 20 2d 57 65 72 72 6f 72 22 20 43 58 58 46 4c 41   -Werror" CXXFLA
0610: 47 53 3d 22 2d 67 22 3c 2f 74 74 3e 2e 20 46 6f  GS="-g"</tt>. Fo
0620: 72 20 6d 6f 72 65 20 73 69 67 6e 69 66 69 63 61  r more significa
0630: 6e 74 20 62 75 69 6c 64 20 74 77 65 61 6b 73 2c  nt build tweaks,
0640: 20 6f 6e 65 20 6d 69 67 68 74 20 62 65 20 72 65   one might be re
0650: 71 75 69 72 65 64 20 74 6f 20 65 64 69 74 20 3c  quired to edit <
0660: 74 74 3e 63 6f 6e 66 69 67 2e 6d 61 6b 65 3c 2f  tt>config.make</
0670: 74 74 3e 20 6f 72 20 3c 74 74 3e 4d 61 6b 65 66  tt> or <tt>Makef
0680: 69 6c 65 3c 2f 74 74 3e 2e 0d 0a 0d 0a 54 68 69  ile</tt>.....Thi
0690: 73 20 6c 69 62 72 61 72 79 20 69 73 20 6d 6f 72  s library is mor
06a0: 65 20 6f 72 20 6c 65 73 73 20 66 75 6e 63 74 69  e or less functi
06b0: 6f 6e 61 6c 20 62 75 74 20 6e 65 65 64 73 20 6d  onal but needs m
06c0: 6f 72 65 20 64 6f 63 73 20 61 6e 64 20 6d 69 67  ore docs and mig
06d0: 68 74 20 73 65 65 20 73 6f 6d 65 20 65 78 70 65  ht see some expe
06e0: 72 69 6d 65 6e 74 61 74 69 6f 6e 20 61 6c 6f 6e  rimentation alon
06f0: 67 20 74 68 65 20 77 61 79 2e 20 65 2e 67 2e 20  g the way. e.g. 
0700: 69 74 20 22 6d 69 67 68 74 20 62 65 20 69 6e 74  it "might be int
0710: 65 72 65 73 74 69 6e 67 22 20 74 6f 20 65 78 74  eresting" to ext
0720: 65 6e 64 20 69 74 73 20 64 61 74 61 20 74 79 70  end its data typ
0730: 65 20 73 75 70 70 6f 72 74 20 74 6f 20 69 6e 74  e support to int
0740: 65 72 6e 61 6c 6c 79 20 75 73 65 20 73 6f 6d 65  ernally use some
0750: 74 68 69 6e 67 20 63 6c 6f 73 65 72 20 74 6f 20  thing closer to 
0760: 6e 61 74 69 76 65 20 76 61 6c 75 65 73 20 28 65  native values (e
0770: 2e 67 2e 20 4a 53 4f 4e 2d 63 6f 6d 70 61 74 69  .g. JSON-compati
0780: 62 6c 65 20 64 61 74 61 20 74 79 70 65 73 29 2c  ble data types),
0790: 20 61 6e 64 20 5b 68 74 74 70 3a 2f 2f 66 6f 73   and [http://fos
07a0: 73 69 6c 2e 77 61 6e 64 65 72 69 6e 67 68 6f 72  sil.wanderinghor
07b0: 73 65 2e 6e 65 74 2f 72 65 70 6f 73 2f 63 77 61  se.net/repos/cwa
07c0: 6c 7c 61 20 73 65 70 61 72 61 74 65 20 6c 69 62  l|a separate lib
07d0: 72 61 72 79 5d 20 69 73 20 75 6e 64 65 72 20 63  rary] is under c
07e0: 6f 6e 73 74 72 75 63 74 69 6f 6e 20 74 6f 20 65  onstruction to e
07f0: 78 70 65 72 69 6d 65 6e 74 20 77 69 74 68 20 74  xperiment with t
0800: 68 61 74 2e 0d 0a 0d 0a 3c 73 74 72 6f 6e 67 3e  hat.....<strong>
0810: 4c 69 63 65 6e 73 65 3c 2f 73 74 72 6f 6e 67 3e  License</strong>
0820: 3a 20 53 69 6d 70 6c 69 66 69 65 64 20 42 53 44  : Simplified BSD
0830: 20 4c 69 63 65 6e 73 65 20 28 61 2e 6b 2e 61 2e   License (a.k.a.
0840: 20 32 2d 43 6c 61 75 73 65 20 42 53 44 20 4c 69   2-Clause BSD Li
0850: 63 65 6e 73 65 2c 20 61 2e 6b 2e 61 2e 20 46 72  cense, a.k.a. Fr
0860: 65 65 42 53 44 20 4c 69 63 65 6e 73 65 29 2e 0d  eeBSD License)..
0870: 0a 0d 0a 55 73 65 66 75 6c 20 6c 69 6e 6b 73 3a  ...Useful links:
0880: 0d 0a 0d 0a 20 20 20 2a 20 20 5b 64 6f 77 6e 6c  ....   *  [downl
0890: 6f 61 64 7c 44 6f 77 6e 6c 6f 61 64 20 74 68 65  oad|Download the
08a0: 20 63 6f 64 65 5d 2e 0d 0a 20 20 20 2a 20 20 43   code]...   *  C
08b0: 72 65 61 74 69 6e 67 20 61 20 73 6f 2d 63 61 6c  reating a so-cal
08c0: 6c 65 64 20 5b 41 6d 61 6c 67 61 6d 61 74 69 6f  led [Amalgamatio
08d0: 6e 42 75 69 6c 64 5d 20 6f 66 20 74 68 65 73 65  nBuild] of these
08e0: 20 73 6f 75 72 63 65 73 2e 0d 0a 20 20 20 2a 20   sources...   * 
08f0: 20 5b 68 74 74 70 3a 2f 2f 77 77 77 2e 73 71 6c   [http://www.sql
0900: 69 74 65 63 6f 6e 63 65 70 74 73 2e 6f 72 67 2f  iteconcepts.org/
0910: 54 48 4d 61 6e 75 61 6c 2e 70 64 66 7c 54 68 65  THManual.pdf|The
0920: 20 6f 6e 6c 79 20 6d 61 6e 75 61 6c 5d 20 66 6f   only manual] fo
0930: 72 20 46 6f 73 73 69 6c 27 73 20 54 48 31 20 6c  r Fossil's TH1 l
0940: 61 6e 67 75 61 67 65 2e 0d 0a 20 20 20 2a 20 20  anguage...   *  
0950: 5b 68 74 74 70 73 3a 2f 2f 64 6f 63 73 2e 67 6f  [https://docs.go
0960: 6f 67 6c 65 2e 63 6f 6d 2f 64 6f 63 75 6d 65 6e  ogle.com/documen
0970: 74 2f 64 2f 31 71 42 44 75 4f 36 54 34 41 2d 4b  t/d/1qBDuO6T4A-K
0980: 4f 77 5a 72 32 57 79 57 54 4c 58 39 58 7a 57 6a  OwZr2WyWTLX9XzWj
0990: 4b 5a 76 62 69 52 4a 59 61 50 61 54 42 45 37 59  KZvbiRJYaPaTBE7Y
09a0: 2f 76 69 65 77 7c 54 68 61 74 20 73 61 6d 65 20  /view|That same 
09b0: 6d 61 6e 75 61 6c 5d 2c 20 70 6f 72 74 65 64 20  manual], ported 
09c0: 74 6f 20 47 6f 6f 67 6c 65 20 44 6f 63 73 20 61  to Google Docs a
09d0: 6e 64 20 65 78 70 61 6e 64 65 64 20 74 6f 20 69  nd expanded to i
09e0: 6e 63 6c 75 64 65 20 64 65 74 61 69 6c 73 20 73  nclude details s
09f0: 70 65 63 69 66 69 63 20 74 6f 20 74 68 69 73 20  pecific to this 
0a00: 41 50 49 2e 0d 0a 20 20 20 2a 20 20 5b 48 6f 77  API...   *  [How
0a10: 54 6f 7c 45 78 63 65 65 64 69 6e 67 6c 79 20 62  To|Exceedingly b
0a20: 72 69 65 66 20 48 6f 77 54 6f 5d 20 66 6f 72 20  rief HowTo] for 
0a30: 74 68 69 73 20 6c 69 62 72 61 72 79 2e 0d 0a 20  this library... 
0a40: 20 20 2a 20 20 5b 74 68 31 5f 6f 62 7c 54 68 65    *  [th1_ob|The
0a50: 20 22 6f 62 22 20 41 50 49 5d 20 74 68 31 20 41   "ob" API] th1 A
0a60: 50 49 20 65 78 74 65 6e 73 69 6f 6e 20 70 72 6f  PI extension pro
0a70: 76 69 64 65 64 20 62 79 20 74 68 69 73 20 63 6f  vided by this co
0a80: 64 65 2e 0a 5a 20 61 33 31 36 32 30 65 35 34 61  de..Z a31620e54a
0a90: 66 62 38 32 63 61 64 35 39 62 61 36 36 30 65 39  fb82cad59ba660e9
0aa0: 32 36 39 33 32 38 0a                             269328.