home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 March / Chip_1998-03_cd.bin / zkuste / delphi / ruzkomp / hyperstr / HSTR(1).ZIP / README.TXT < prev   
Text File  |  1997-12-01  |  9KB  |  220 lines
  1.                           *** HyperString v2.0 ***
  2.               (c)1996,1997 EFD Systems, All rights reserved
  3.                              efd@mindspring.com
  4.  
  5.                  *** THIS IS NOT PUBLIC DOMAIN SOFTWARE ***
  6.        See below for license agreement, disclaimer and installation.
  7.  
  8.  
  9.     Introduction ---------------------------------------------------------
  10.  
  11.     Welcome to HyperString!
  12.  
  13.     One of the most significant new features with Delphi32 is long dynamic
  14.     strings.  However, the built-in library functions don't really reveal
  15.     the full potential of these new strings. HyperString provides over 200
  16.     fast, efficient string management routines to help you realize the full
  17.     power of this highly versatile new data type.
  18.  
  19.  
  20.     A Taste of HyperString -----------------------------------------------
  21.  
  22.     Below are a few of the many features of HyperString.
  23.  
  24.     String Searching and Editing - Virtually every imaginable low level
  25.     function for string searching (forward, reverse, case insensitive,
  26.     wildcard, "fuzzy", etc.) and editing.  Most of the low level routines
  27.     are written in optimized BASM for maximum speed and efficiency.
  28.  
  29.     Arrays - Unique implementation of dynamic numeric arrays (integer,
  30.     single, double, etc.) using long dynamic strings as containers. The
  31.     easiest, safest way to create and use dynamic arrays in Delphi.
  32.  
  33.     Expression Evaluation - The highly compact CalcStr() routine is a
  34.     working demo of the power of HyperString.  Basic math operators,
  35.     parentheses, exponents and functions such as LN() and ABS() are all
  36.     supported in fewer than 100 lines of source code. Additional functions
  37.     are easily added.
  38.  
  39.     Tokens - A full set of token routines support the creation of
  40.     sophisticated lookup tables and hierarchial data structures inside
  41.     strings.  Easily add, insert, delete and replace tokens using multiple
  42.     delimiters.
  43.  
  44.     Unsigned Integers - For some reason, Borland is reluctant to provide
  45.     true 32-bit unsigned integers (Cardinal is only 31 bits) so we did it.
  46.     Functions are provided for unsigned integer add, subtract, multiply,
  47.     divide, compare and (of course) convert to/from string format.
  48.  
  49.  
  50.     User Comments --------------------------------------------------------
  51.  
  52.     "Just wanted to let you know that I've now re-written a substantial
  53.     number of HomeSite's string manipulation routines using HyperString,
  54.     and the resulting performance boost is simply incredible. I now have
  55.     functions that operate many times faster than before, which will be a
  56.     real hit with my users. So, thanks for the excellent work on your
  57.     product! "
  58.  
  59.     --- Nick Bradbury; author of HomeSite HTML editor
  60.  
  61.  
  62.     Installation ---------------------------------------------------------
  63.  
  64.     Installing the HyperString library is as easy as 1-2-3:
  65.  
  66.     1) Copy HYPERSTR.PAS (or the DCU) to your Delphi Library directory.
  67.        (..\DELPHI\LIB)
  68.  
  69.     2) Copy HYPERSTR.HLP and HYPERSTR.CNT to your Delphi Help directory.
  70.        (..\DELPHI\HELP)
  71.  
  72.     3) (Optional, but highly recommended) With minimal effort, the WinHelp
  73.        docs for HyperString can be seamlessly integrated into Delphi's
  74.        on-line Help for convenient access during coding.
  75.  
  76.        First, make a backup copy of ..\DELPHI\HELP\DELPHI.CNT (DELPHI3.CNT)
  77.  
  78.        Edit DELPHI.CNT (it's a simple text file) using NOTEPAD, WORDPAD or
  79.        the ASCII editor of your choice.  Insert 2 lines as follows based
  80.        on your version of Delphi (version 2 or 3).
  81.  
  82.        *** Delphi2 ***
  83.        --------------------------------------------------------------
  84.        Insert as Line #3   > :Index HyperString Library =hyperstr.hlp
  85.  
  86.        Insert as Last Line > :Include hyperstr.cnt
  87.        --------------------------------------------------------------
  88.  
  89.        *** Delphi3 ***
  90.        --------------------------------------------------------------
  91.        Insert in Index Section   > :Index HyperString Library =hyperstr.hlp
  92.        (near top of file)
  93.  
  94.        Insert in Include Section > :Include hyperstr.cnt
  95.        (near end of file)
  96.        --------------------------------------------------------------
  97.  
  98.  
  99.        The colons are to be added as part of each line. Once you've
  100.        finished editing, DELPHI.CNT should look something like this:
  101.  
  102.        --------------------------------------------------------------
  103.           :Base delphi.HLP>main
  104.           :Title Delphi Help
  105.           :Index HyperString Library =hyperstr.hlp
  106.                     .
  107.                     .
  108.                     .
  109.           :Include hyperstr.cnt
  110.  
  111.        --------------------------------------------------------------
  112.  
  113.        NOTE:
  114.  
  115.        Be sure to press [Enter] after typing the last line in the file.
  116.        WinHelp will sometimes ignore lines that are not terminated by a
  117.        CR/LF pair. In other words, the very last line in DELPHI.CNT should
  118.        appear to be an empty line as shown above.
  119.  
  120.        Save the file and you're done!
  121.  
  122.        The next time you access Delphi Help, you'll receive the message,
  123.  
  124.                    "Preparing Help files for first use"
  125.  
  126.        This indicates that WinHelp is rebuilding the Delphi Help indexes to
  127.        include HyperString. Once this is complete, you should see a new
  128.        entry for HyperString at the bottom of the Help Contents page and
  129.        entries for the HyperString routines should be in the Index.
  130.  
  131.  
  132.     Using HyperString ----------------------------------------------------
  133.  
  134.     HyperString is a non-visual library.  Once installed, simply add
  135.     'HyperStr' to the 'Uses' clause in your unit and you're ready to
  136.     make use of all the HyperString routines.
  137.  
  138.  
  139.     Ordering HyperString -------------------------------------------------
  140.  
  141.     Once you use HyperString, you may decide that you would like to have
  142.     the full source code.  Currently there are 3 ways to order.
  143.  
  144.     1) From the World Wide Web.  Using a major credit and a secure link
  145.     from our web site at:
  146.  
  147.     http://efd.home.mindspring.com
  148.  
  149.     2) By mail.  Send check or money order for $30 + $2 shipping (US
  150.     banks only) to:
  151.  
  152.     EFD Systems
  153.     304 Smokerise Circle
  154.     Marietta, GA 30067
  155.     USA
  156.  
  157.     3) From CompuServe.  This option has the advantage of immediate
  158.     (usually within 24 hrs) electronic delivery of the source code and no
  159.     shipping or handling fee.
  160.  
  161.     Type "GO SWREG" and register #14172
  162.  
  163.  
  164.     UnInstall ------------------------------------------------------------
  165.  
  166.     Should you decide that HyperString is not for you (unlikely but
  167.     possible <g>), delete the 3 files mentioned above.  If you modified
  168.     DELPHI.CNT, simply re-edit the file and delete the 2 lines that were
  169.     added or better yet, overwrite the file with the backup copy.
  170.  
  171.  
  172.     License Agreement and Disclaimer -------------------------------------
  173.  
  174.                  *** THIS IS NOT PUBLIC DOMAIN SOFTWARE ***
  175.  
  176.     By using this software, you indicate your acceptance of the terms
  177.     and conditions below.
  178.  
  179.     This software (the product) is copyright 1996-97 EFD Systems, all
  180.     rights reserved.  Except as detailed herein, you are granted a license
  181.     to use this software without further payment of fees.  The compiled
  182.     software (but not the source code) may be distributed to others for
  183.     similar use, provided that no fees are charged (excluding on-line
  184.     access fees) and the software is distributed in it's entirety,
  185.     including all documentation.
  186.  
  187.     This software shall NOT be used in the production of any similar or
  188.     competing product, i.e. any product which reproduces or duplicates some
  189.     or all of this product's features, functionality and intended use.  If
  190.     your intended use does not clearly conform to these requirements, you
  191.     must request and receive written permission from the author before
  192.     using the software.
  193.  
  194.     A source code license (if purchased) grants the user the right to view
  195.     and modify the source code on a private, personal use basis.  Except as
  196.     noted above, machine readable object code derived from the source may
  197.     be incorporated into software authored by the licensee.  The source code
  198.     itself remains the proprietary property of EFD Systems and shall not be
  199.     reproduced or redistributed under any circumstances.  Redistribution
  200.     of the source code; whether deliberate, the result of negligence or
  201.     otherwise, will be considered a willful, intentional copyright
  202.     violation.
  203.  
  204.     THIS SOFTWARE IS PROVIDED SOLELY AS-IS AND WITHOUT WARRANTY INCLUDING
  205.     WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR
  206.     FITNESS FOR A PARTICULAR PURPOSE.  THE USER AGREES TO INDEMNIFY AND
  207.     HOLD THE AUTHOR HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS ARISING
  208.     FROM OR RELATED TO USE OF THE PRODUCT. UNDER NO CIRCUMSTANCES SHALL THE
  209.     AUTHOR'S LIABILITY EXCEED THE SOFTWARE LICENSE FEE.
  210.  
  211.     By using this software, you indicate your acceptance of the terms and
  212.     conditions above.
  213.  
  214.  
  215.     Revision History -----------------------------------------------------
  216.  
  217.     v1.0 - 96/12/25, Original release (Happy holidays).
  218.     v1.5 - 97/06/01, Many new routines, instructions for Delphi 3.
  219.     v2.0 - 97/08/01, Added dynamic arrays and many new features.
  220.