home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / qb / pc-xref4.lzh / SORTF.DOC < prev    next >
Text File  |  1985-12-27  |  4KB  |  94 lines
  1.                               SORTF Command
  2.  
  3.                     (c) Copyright Vernon D. Buerg 1985
  4.                         Version 2.15 - December 27, 1985
  5.  
  6.  
  7. Purpose:   The SORTF command reads data from an ASCII file, sorts the
  8.            records, and writes the data to another file.
  9.  
  10. Format:
  11.            SORTF [d:][path]fname[.ext] [d:][path]fname[.ext]
  12.                  [/+nnn[,len]]
  13.                  [/R]
  14.                  [/C]
  15.  
  16. Remarks:   Records read from the input file ending with a carriage
  17.            return and line feed are considered logical records and may
  18.            be up to 256 characters in length.
  19.  
  20.            The records are sorted into ascending ASCII character order
  21.            unless /R is supplied to reverse the order.
  22.  
  23. |          The /C option may be added to cause SORTF to treat the key
  24. |          fields as case insensitive data. That is, lower case letters
  25. |          in the key field are treated as upper case letters.
  26.  
  27.            The key is taken from the first character position, unless
  28.            the /+ operand is used to specify the location of the key
  29.            within the records. The position may be a value from one
  30.            to 255. The first 12 characters at that position are used
  31. |          as the record key unless the 'len' operand is used to
  32. |          specify the key length. The key length may be a value from
  33. |          1 to 99.
  34.  
  35.            For example, to sort a file in descending order with the
  36.            keys in position 10:
  37.  
  38.                 SORTF TEST.DAT TEST.SRT /R/+10
  39.  
  40.            Or, to sort the same file using keys with 24 characters:
  41.  
  42.                 SORTF TEST.DAT TEST.SRT /R/+10,24
  43.  
  44.            Depending on the amount of memory available, up to 40000
  45.            records, or a file up to 16-Mb, may be sorted.
  46.  
  47.            The advantages of using SORTF instead of the SORT filter are:
  48.                 - files larger than 63K may be sorted
  49.                 - less time is required
  50.  
  51.            For best results, place the input file on the fastest
  52.            available drive, e.g. RAM disk.
  53.  
  54. Notes:
  55.         Written by Vernon Buerg for the  IBM PC using DOS 2.0 and is
  56.         supplied for personal use. All rights reserved.
  57.  
  58.         Not for sale or hire. Commercial use is prohibited. This means
  59.         that no fee may be charged for any copies.  Nor may SORTF be
  60.         included (or bundled) with other goods or services. Exceptions
  61.         may be granted upon written request only.
  62.  
  63.         If you find SORTF useful, you are encouraged to make a contribution
  64.         to defray development costs ($10 suggested).
  65.  
  66.         For use by corporations and other institutions, contact me or
  67.         AAI Systems for a licensing agreement.
  68.  
  69.                 Vernon D. Buerg
  70.                 c/o AAI Systems, Inc.
  71.                 456 Lakeshire Drive
  72.                 Daly City, CA 94015
  73.  
  74.                 RBBS: (415) 994-2944
  75.                 CompuServe: 70007,1212
  76.  
  77.  
  78. Version History:
  79.  
  80.         2.0, July 11, 1985.
  81.            o  Corrects CR/LF problem. Remember, it is assumed that
  82.               all "records" end in a carriage return (CR). Those
  83.               that do not may appear as part of other records to
  84.               a text editor.
  85.  
  86.         2.1, August 3, 1985
  87.            o  Corrects a problem sorting files larger than 64K.
  88.  
  89.         2.15, December 27, 1985
  90. |          o  Corrects problems with first record of file.
  91. |          o  Adds /C option to treat keys as case insensitive data
  92. |          o  The key length may be specified on the command line
  93.  
  94.