home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 2 / ctrom_ii_b.zip / ctrom_ii_b / PROGRAM / PASCAL / PARSTP20 / PARSER.DOC < prev    next >
Text File  |  1993-10-25  |  6KB  |  145 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                               PARSER/TP 2.0                                 *
  13. * Recursive Decent Expression Parser for Turbo Pascal, Loewy Ron, 1991, 1993. *
  14. * Parser.doc, Last Update : Oct. 25, 1993                                     *
  15. *******************************************************************************
  16.  
  17. File List
  18. ---------
  19.  
  20.  This package contains the following files :
  21.  
  22.  PARSER  .PAS   - Parser Turbo Pascal Source file.
  23.  PARSER  .DOC   - Parser/TP documentation file. 
  24.  PARSER  .REG   - Registration File.
  25.  PROGRAMS.TXT   - ISoft D&M shareware products description.
  26.  CALC    .PAS   - Simple Parser Turbo Pascal test sample.
  27.  PARSEDB .TPU   - Parser Symbol Table manager Module.
  28.  DBENGBAS.TPU   - Parser Symbol Table manager Module.
  29.  DBENGMEM.TPU   - Parser Symbol Table manager Module.
  30.  TBLBASE .TPU   - Parser Symbol Table manager Module.
  31.  QUICKSRT.TPU   - Parser Symbol Table manager Module.
  32.  COMBSRT .TPU   - Parser Symbol Table manager Module.
  33.  MERGSORT.TPU   - Parser Symbol Table manager Module.
  34.  DATEUNIT.TPU   - Parser Symbol Table manager Module.
  35.  MEMTBOBJ.TPU   - Parser Symbol Table manager Module.
  36.  PARSER  .TPH   - Parser/TP online help file in THELP/IDE format.
  37.  PARSER  .HLP   - Parser/TP online help file in WINHELP format.
  38.  
  39. Why Register
  40. ------------
  41.  
  42.   Parser/TP is a shareware product, if you find this product valuable, 
  43.  please register it. This section describes the reasones you should register.
  44.  
  45.   By registering Parser/TP you will receive the complete source code to the 
  46.  parser symbol table manager, and will be able to compile parser for inclusion
  47.  in your protected mode and windows programs.
  48.  
  49.   Registered Parser/TP users get full no-rotality usage permission.
  50.  
  51. Whats new
  52. ---------
  53.  
  54. V2.0
  55.   - Added a symbol table, and variable names can be up to 30 characters.
  56.   - Improved error reporting.
  57.   - Improved lexer.
  58.   - Improved CALC demo program. 
  59.   - The parser getExpr interface receives the source formula string as a
  60.     parameter.
  61.  
  62. V1.1 
  63.   - Added better documentation in PARSER.PAS source.
  64.   - Added A Simple Sample program - CALC.PAS.
  65.   - From this version Parser is distributed by 
  66.     ISoft D&M, P.O.B 5517, Coralville IA 52241, U.S.A
  67.  
  68. Introduction
  69. ------------
  70.  
  71.   Parser/TP is a recursive decent expression parser unit for Turbo-Pascal, this 
  72.  unit includes the 5 basic math. operators (+ - * / ^), and some basic
  73.  mathematical functions (sin, exp, cos, ln, log10, log2, abs, arctan, sqr,
  74.  sqrt, tan, cotan, arcsin, arccos) and 2 constants (pi, e). Parser can be 
  75.  used to receive formula input from the user, and perform the neccessary 
  76.  calculations during program runtime. Parser/TP supports a dynamic symbol 
  77.  table, that is created and maintained during the parser's execution. New 
  78.  variables are created when they are referenced for the first time, and 
  79.  receive the initial value of 0.0 . Variables values can be set by using the
  80.  = operator (e.g. myvar = sin(anotherVar)*35 ), and used in user formulas.
  81.  
  82. Operation
  83. ---------
  84.  
  85.   Simply use parser unit in your program using the USES clause, when ever you
  86.  want to parse a string formula do :
  87.  
  88.         myResult := getExpr(formulaString, validity);
  89.         if (validity = false) then
  90.                 tellError { the formula has an error at the errAt byte }
  91.         else
  92.                 tellResult(myResult);
  93.  
  94.   Please notice - the source code for the CALC program is provided, so you will 
  95.  probably find it easy to understand that example after you will look into the 
  96.  code.
  97.  
  98. Warranty
  99. --------
  100.  
  101.   There is no warranty what so ever, This software package is supplied as is,
  102.  The distributer (ISoft D&M), or the author (Loewy Ron), are not,
  103.  and will not be responsible for any damages, lost profits, 
  104.  or inconveniences caused by the use, or inability to use this package. 
  105.  The use of the package is at your own risk. By using (or attempting to use) 
  106.  the package you agree to this.
  107.  
  108. General
  109. -------
  110.  
  111.   Parser/TP is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  112.   
  113.   Parser/TP is a (c) copyright 1991, 1993 of Loewy Ron.
  114.  
  115.   Parser/TP is a shareware package, please register your copy. 
  116.   To register your copy of Parser please refer to the supplied
  117.   PARSER.REG file. 
  118.  
  119.   Other programs distributed by ISoft D&M are described in the supplied  
  120.   PROGRAMS.TXT file.
  121.  
  122. Contact
  123. -------
  124.  
  125.   Please contact :
  126.  
  127.   ISoft D&M,  
  128.   P.O.Box 5517
  129.   Coralville IA 52241,
  130.   U.S.A
  131.  
  132.   E-Mail  : Compuserve - 76350,333
  133.   Phone   : (319) 351-8413
  134.  
  135.   To contact the author directly :
  136.  
  137.   E-Mail  : Compuserve - 100274,162
  138.  
  139. Credits
  140. -------
  141.  
  142.   Parser/TP was created by Ron Loewy.
  143.  
  144.   Turbo Pascal is a Trademark/Copyright of Borland International. 
  145.