home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / dcdlib10.arj / READ.ME < prev   
Encoding:
Text File  |  1991-10-31  |  3.2 KB  |  94 lines
  1. DCDLIB10.ZIP        Command/filename/text decoding routines
  2. ============
  3.  
  4.     Version:    1.0
  5.     Author:        Graham Klyne
  6.     Released:    25-Oct-1991
  7.  
  8. This archive contains a collection of procedures written in C for
  9. analysing text strings and decoding data values from their textual
  10. representations.  I use these routines extensively in my own
  11. programming to analyse command lines and to parse filenames.
  12.  
  13. Documentation is contained in the C source code, so look there
  14. for detailed information.  Files which may be of particular
  15. interest are DCDTEM.C and DCDPTH.C.
  16.  
  17. The source files here consist of:
  18.  
  19. DCDDEF.H    contains type definitions and function prototypes for
  20.         routines defined by this library.
  21.  
  22. DCDANS.C    decode YES/NO value from string.
  23.  
  24. DCDCMD.C    assembles the command line used to run a C program.
  25.  
  26. DCDDEF.C    routines for applying defaults to filename
  27.         specification strings.
  28.  
  29. DCDFLT.C    decode floating point values from a string.
  30.  
  31. DCDNAM.C    decode name values from a string
  32.  
  33. DCDNUM.C    decode integer numbers (any radix) from a string
  34.  
  35. DCDPAR.C    routines for reading and parsing a standard command
  36.         line.  (This was originally written to support a style
  37.         of command-line interface which was more common in the
  38.         early 80's, so is probably not of such interest to
  39.         'modern' programmers.)
  40.  
  41. DCDPTH.C    routines for parsing filename specifications from a
  42.         string.
  43.  
  44. DCDSPC.C    routines for scanning whitespace in a string.
  45.  
  46. DCDSTR.C    routines for scanning substring values (possible quoted)
  47.         from a string.
  48.  
  49. DCDTOK.C    routine for scanning a 'token' from a string.
  50.  
  51. DCDTEM.C    collection of routines for parsing and decoding values
  52.         from a string based upon a supplied template.  This
  53.         module provides a facility a bit like 'sscanf', but
  54.         it is MUCH MORE flexible.  There are provisions for
  55.         optional, alternate, repeated and abbreviated values
  56.         in the string, and others.
  57.  
  58. DCDTST.C    this is a test harness for the template-based test decoding
  59. DCDTST.LNK    routines.  It also tests the individual value-decoding
  60.         routines (which are called by the template-based decoder).
  61.  
  62. DEFTST.C    this is a test harness for the routine which applies
  63. DEFTST.LNK    default values to a filename.
  64.  
  65. PARTST.C    test harness for command line parsing routines.
  66. PARTST.LNK
  67.  
  68. DCDLIB        MAKE file for all the above (primitive Microsoft style)
  69.         Builds all modules into 4 libraries -- DCDLIBS, DCDLIBM,
  70.         and DCDLIBL for small, medium and large model versions
  71.         of the code.
  72.  
  73. The programs have all been compiled and tested using
  74. Microsoft C version 5.1.  Apart from a few library calls,
  75. the programs use features defined for ANSI C, so should
  76. compile with most compilers.
  77.  
  78. The copyright in these programs is owned by Graham Klyne,
  79. but permission is granted for anyone to distribute and make
  80. free use of them in any way they see fit, provided that no
  81. fee is charged for their distribution.
  82.  
  83. If you have any questions or comments, I routinely poll the
  84. programmer's areas of the following UK public-access bulletin
  85. boards:
  86.     Golly!            0734 320812
  87.     Hawk's Castle        0344 411621
  88.     Mission Impossible    0602 654329 or 0602 654680
  89.  
  90. Alternatively, you can fax me on 0235 847520 (Outside UK: +44 235 847520).
  91.  
  92. Graham Klyne
  93. ~~~~~~~~~~~~
  94.